使用Supervisor的自定义PostgreSQL Dockerfile挂载卷启动失败求助

1. 目录权限不匹配（最常见原因） #

宿主机的/pg_data目录默认属于宿主机用户，而容器内PostgreSQL进程通常以postgres用户（UID/GID一般为999）运行，没有读写目录的权限。

• 直接在宿主机执行命令修复权限：

  chown -R 999:999 /pg_data
  

• 也可以在Docker Compose中指定PostgreSQL进程的运行用户，确保与宿主机目录权限匹配：

  services:
    your-service:
      user: "999:999"
  

2. 空目录未完成初始化 #

如果是首次挂载空目录，而你的自定义镜像没有包含PostgreSQL自动初始化逻辑（官方Postgres镜像会自动处理空目录初始化，但Supervisor管理场景下可能跳过了这一步）：

• 先启动临时容器导出初始化数据：

  docker run -d --name temp-postgres your-custom-image
  docker cp temp-postgres:/var/lib/postgresql/11/main /pg_data/
  docker stop temp-postgres && docker rm temp-postgres
  

• 再重新启动带卷挂载的容器

3. 查看PostgreSQL启动日志定位具体错误 #

Supervisor的报错只显示退出状态，需要查看PostgreSQL的具体日志：

• 进入容器查看日志：

  docker exec -it your-container-name tail -f /var/log/supervisor/postgresql.log
  

• 常见日志错误包括：数据目录不存在、配置文件损坏、端口被占用等，可根据日志直接定位问题

4. Supervisor配置错误 #

检查你的Supervisor配置文件中PostgreSQL的启动命令，确保指定了正确的数据目录：

• 确认启动命令包含数据目录参数，比如：

  [program:postgresql]
  command=/usr/lib/postgresql/11/bin/postgres -D /var/lib/postgresql/11/main
  

• 或者确保postgresql.conf中data_directory参数指向正确路径

5. Docker Compose卷配置格式错误 #

你提供的卷配置格式有误，正确的绑定挂载写法应该是：

services:
  your-service:
    volumes:
      - /pg_data:/var/lib/postgresql/11/main

注意不要额外添加postgres后缀，否则会被识别为命名卷而非宿主机绑定挂载

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