PostgreSQL 14开启huge_pages后无法启动求助

问题详情 #

开启huge_pages = on后PostgreSQL无法启动，报错信息：

FATAL: could not map anonymous shared memory: Cannot allocate memory
HINT: This error usually means that PostgreSQL's request for a shared memory segment exceeded available memory, swap space, or huge pages. To reduce the request size (currently 2768240640 bytes)

执行cat /proc/meminfo | grep -i huge得到大页状态：

AnonHugePages:         0 kB
ShmemHugePages:        0 kB
FileHugePages:         0 kB
HugePages_Total:    1000
HugePages_Free:     1000
HugePages_Rsvd:        0
HugePages_Surp:        0
Hugepagesize:       2048 kB
Hugetlb:         2048000 kB

环境：Ubuntu 22.04，服务器总内存16GB；shared_buffers设为1GB时可正常启动，设为2GB时启动失败。

原因分析 #

当前配置的大页总容量为1000 * 2048KB = 2GB，但PostgreSQL请求的共享内存约为2.58GB，超出了大页的总可用容量。当shared_buffers设为2GB时，PostgreSQL的实际共享内存需求还包含WAL缓冲区、其他内部共享结构，因此总请求会超过2GB，导致大页分配失败。

解决步骤 #

1. 计算所需大页数量
   按shared_buffers=2GB计算，额外预留20%的余量应对其他共享内存结构，总需求约为2.4GB，换算为大页数：2.4GB / 2MB = 1229，向上取整为1300（预留足够冗余）。

2. 修改系统大页配置

   • 编辑/etc/sysctl.conf，添加或修改参数：

     vm.nr_hugepages = 1300
     

   • 执行sysctl -p使配置立即生效。

3. 验证大页配置
   重新执行cat /proc/meminfo | grep -i huge，确认HugePages_Total和HugePages_Free已更新为设置的数值。

4. 权限检查（可选）
   确保postgres用户有权限锁定内存，编辑/etc/security/limits.conf添加：

   postgres soft memlock unlimited
   postgres hard memlock unlimited
   

   配置完成后重启系统或postgres用户会话。

5. 重启PostgreSQL
   启动服务，确认不再出现启动失败的报错。

内容的提问来源于stack exchange，提问作者jimbolino