同一PostgreSQL镜像docker run正常，docker-compose启动异常排查

可能的原因及排查方案 #

1. 宿主机挂载目录权限不匹配 #

Dockerfile中已将postgres用户的UID/GID改为9999，容器内/var/lib/postgresql/data目录归属于该用户。但docker-compose中挂载了宿主机/home/database到该路径，若宿主机目录的所有者/组ID不是9999，容器内postgres用户将无法读写目录，导致initdb无法创建数据文件。

• 验证：执行ls -ld /home/database查看宿主机目录权限，确认所有者UID和组GID是否为9999。
• 解决：修改宿主机目录权限：chown -R 9999:9999 /home/database，确保容器内用户拥有读写权限。

2. SELinux上下文限制 #

虽然挂载时使用了:z标签标记共享SELinux上下文，但宿主机SELinux策略仍可能阻止容器内用户访问挂载目录。

• 验证：临时关闭SELinux测试：setenforce 0，若容器恢复正常则说明是SELinux问题。
• 解决：为宿主机目录添加正确的SELinux上下文：chcon -Rt svirt_sandbox_file_t /home/database，或使用:Z标签（私有上下文）重新挂载（注意不要与其他容器共享该目录）。

3. 环境变量配置不一致 #

docker-compose中通过env_file加载了./common/config/db/env，若该文件中存在覆盖Dockerfile设置的变量（如修改PGDATA路径），或缺失PostgreSQL初始化必需的环境变量（如POSTGRES_USER、POSTGRES_PASSWORD），会导致initdb执行失败。

• 验证：对比docker run时使用的环境变量与env文件内容，检查是否存在冲突或缺失。
• 解决：确保env文件中的变量与Dockerfile兼容，且包含初始化所需的必要参数。

4. 容器Capabilities限制过严 #

docker-compose中对postgresql服务设置了cap_drop: - ALL，仅添加了有限的capabilities。虽然这些权限看似足够，但initdb可能需要额外权限（如文件系统相关的特殊权限），而docker run时未做此类限制。

• 验证：暂时注释docker-compose中postgresql服务的cap_drop和cap_add配置，重新启动容器观察是否恢复正常。
• 解决：若确为权限问题，添加initdb所需的额外capabilities，或调整权限策略。

5. 健康检查脚本适配问题 #

虽然docker run时健康检查正常，但docker-compose使用自定义harbor网络，若docker-healthcheck.sh中的连接参数（如用户名、密码、端口）与env文件中的配置不匹配，会导致健康检查失败，容器标记为unhealthy。

• 验证：进入容器执行docker-healthcheck.sh脚本，查看具体错误信息：docker exec -it harbor-db /docker-healthcheck.sh。
• 解决：调整健康检查脚本中的参数，确保与容器内PostgreSQL的配置一致。

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