PostgreSQL-x64-10启动失败：共享内存不足如何解决？

Question

PostgreSQL-x64-10 启动失败，提示“共享内存不足”是常见问题，多发生在系统共享内存配置偏低或被其他进程占用过多时。该问题通常表现为启动日志中出现 "could not create shared memory segment: No space left on device" 或 "System V shared memory exhausted" 错误。根本原因常为内核参数 shmmax、shmall 设置过小，或 tmpfs 挂载的 /dev/shm 空间不足。尤其在物理内存较大但未调整默认共享内存限制的服务器上更易发生。解决方法包括：调整 /etc/sysctl.conf 中 kernel.shmmax 和 kernel.shmall 值，确保其支持 PostgreSQL 所需的 shared_buffers；检查并清理 /dev/shm 占用；必要时重启数据库服务或系统。适用于生产环境部署前的系统调优。

Answer 1

PostgreSQL-x64-10 启动失败：共享内存不足问题深度解析

1. 问题现象与典型错误日志

在部署 PostgreSQL-x64-10 数据库时，系统启动过程中常出现如下错误信息：

    FATAL:  could not create shared memory segment: No space left on device
    DETAIL:  Failed system call was shmget(key=5432001, size=1234567890, 03600).
    HINT:  This error usually means that PostgreSQL's request for a shared memory segment exceeded available memory, or exceeded an operating system limit.
    

或：

    FATAL:  System V shared memory exhausted
    

此类报错表明 PostgreSQL 在尝试创建 System V 共享内存段时失败，无法完成初始化。该问题多见于物理内存充足但内核参数未调优的 Linux 系统中。

2. 根本原因分析

共享内存是 PostgreSQL 实现高效并发访问的核心机制之一，主要用于存储 shared_buffers、WAL 缓冲区、锁管理器等关键结构。其底层依赖操作系统提供的 System V IPC 机制或 mmap 映射 tmpfs 文件系统（如 /dev/shm）。

导致“共享内存不足”的主要原因包括：

• kernel.shmmax 设置过小：单个共享内存段最大尺寸限制低于 PostgreSQL 所需。
• kernel.shmall 设置过小：系统允许分配的总页数不足。
• /dev/shm 空间被占满或挂载大小受限：影响基于 mmap 的共享内存使用。
• 残留 IPC 资源未清理：前次异常退出后遗留的共享内存段和信号量未释放。
• 容器化环境中资源隔离配置不当：Docker/Kubernetes 默认限制共享内存大小。

3. 深度排查流程图

graph TD
            A[PostgreSQL启动失败] --> B{检查错误日志}
            B --> C["包含 'No space left on device' 或 'shmget' 错误?"]
            C -->|Yes| D[确认是否为共享内存问题]
            D --> E[查看当前shm参数]
            E --> F[/sbin/sysctl kernel.shmmax kernel.shmall/]
            F --> G{参数值是否合理?}
            G -->|No| H[调整/etc/sysctl.conf并应用]
            G -->|Yes| I[检查/dev/shm使用情况]
            I --> J[df -h /dev/shm]
            J --> K{空间是否接近满载?}
            K -->|Yes| L[清理无用文件或重挂载]
            K -->|No| M[检查IPC资源残留]
            M --> N[ipcs -m; ipcs -s]
            N --> O{存在大量未释放资源?}
            O -->|Yes| P[ipcrm 清理或重启系统]
            O -->|No| Q[考虑容器环境限制]
            Q --> R[docker run --shm-size=?]
            P --> Z[重启PostgreSQL服务]
            H --> Z
            L --> Z
            Z --> AA[验证pg_ctl start是否成功]

4. 关键系统参数详解

参数名	含义	推荐设置（16GB RAM示例）	配置文件位置
kernel.shmmax	单个共享内存段最大字节数	17179869184 (16GB)	/etc/sysctl.conf
kernel.shmall	系统可分配的共享内存总页面数	4194304 (16GB / 4KB page)	/etc/sysctl.conf
kernel.shmmni	系统范围内共享内存段最大数量	4096	/etc/sysctl.conf
vm.overcommit_memory	内存分配策略（建议设为2）	2	/etc/sysctl.conf
/dev/shm 挂载大小	tmpfs 文件系统容量	至少等于 shared_buffers 大小	/etc/fstab 或 mount 命令

5. 解决方案实施步骤

1. 编辑 /etc/sysctl.conf 添加以下内容：

2. # PostgreSQL 10 recommended shared memory settings
   kernel.shmmax = 17179869184
   kernel.shmall = 4194304
   kernel.shmmni = 4096
   vm.overcommit_memory = 2
           

3. 应用配置：sysctl -p
4. 检查 /dev/shm 使用情况：df -h /dev/shm
5. 若空间不足，可重新挂载：mount -o remount,size=8G /dev/shm
6. 清理残留 IPC 资源：ipcs -m | grep postgres | awk '{print $2}' | xargs -I {} ipcrm -m {}
7. 同样处理信号量：ipcs -s | grep postgres | awk '{print $2}' | xargs -I {} ipcrm -s {}
8. 对于 Docker 容器，启动时指定：--shm-size=1g
9. 修改 postgresql.conf 中 shared_buffers 建议不超过物理内存的 25%
10. 重启 PostgreSQL 服务：systemctl restart postgresql-10
11. 验证启动状态：journalctl -u postgresql-10 --since "1 min ago"

6. 生产环境最佳实践建议

在大规模部署 PostgreSQL 前，应将共享内存调优纳入标准化运维流程：

• 自动化脚本检测并设置 sysctl 参数。
• 监控 /dev/shm 使用率，设置告警阈值。
• 定期审计 IPC 资源，防止泄漏积累。
• 结合 cgroup v2 对容器环境进行精细化内存控制。
• 使用 systemd 配置 Postgres 启动依赖于特定 tmpfs 挂载点。
• 记录每次变更的参数值与性能表现，形成基线模型。
• 在虚拟化平台（如 VMware、OpenStack）上确保客户机操作系统能感知真实物理内存。
• 避免多个实例共用同一主机时未做资源隔离。
• 启用 HugePages 可进一步提升共享内存效率（需额外配置）。
• 建立故障恢复预案，包含快速清理 IPC 和重启流程。