PostgreSQL通过docker-compose部署正常，docker stack deploy部署失败

你的PostgreSQL服务在单机docker-compose up下能正常就绪，但Docker Swarm部署时卡在初始化阶段反复重启——这种情况大多和Swarm与单机Compose在存储卷处理、权限管理上的差异有关，结合你给出的截断日志（停在目录初始化步骤），我整理了几个实用的排查方向：

1. 优先解决存储卷权限问题 #

PostgreSQL容器依赖postgres用户（UID=999）拥有数据目录/var/lib/postgresql/data的读写权限，而Swarm的named volumes在权限继承逻辑上和单机Compose略有不同：

• 临时快速修复：先手动创建卷并修正权限，再重新部署服务：

  # 创建指定数据卷
  docker volume create kong-db-data
  # 用alpine容器修复卷内目录的权限归属
  docker run --rm -v kong-db-data:/data alpine chown -R 999:999 /data
  

• 持久化配置方案：在docker-compose.yml中添加init容器，每次服务启动前自动修复权限：

  services:
    kong-database:
      image: postgres:你的镜像版本号
      volumes:
        - kong-db-data:/var/lib/postgresql/data
      deploy:
        # 你的其他Swarm部署配置...
      init_containers:
        - name: fix-db-permissions
          image: alpine:latest
          command: ["chown", "-R", "999:999", "/var/lib/postgresql/data"]
          volumes:
            - kong-db-data:/var/lib/postgresql/data
  

2. 排查Swarm的资源与调度限制 #

• 资源不足导致崩溃：PostgreSQL初始化需要一定内存支撑，如果节点内存不足会触发进程崩溃重启。可以给服务添加资源预留/限制：

  deploy:
    resources:
      reservations:
        memory: 512M
      limits:
        memory: 1G
  

• 本地卷调度错误：如果使用的是本地卷（非分布式存储），要确保服务被调度到卷所在的节点，否则会在新节点重新初始化空卷，导致循环重启：

  deploy:
    placement:
      constraints:
        - node.hostname == 你的目标节点名称
  

3. 检查初始化配置与自定义脚本 #

• 确认POSTGRES_USER、POSTGRES_PASSWORD等核心环境变量是否正确设置，Swarm中如果用了secrets存储敏感数据，要确保已正确挂载到容器内。
• 如果挂载了自定义初始化脚本到/docker-entrypoint-initdb.d/，先移除这些脚本测试——如果脚本执行失败（比如SQL语法错误、依赖缺失），PostgreSQL会在初始化阶段崩溃重启。

4. 获取完整的错误日志 #

你提供的日志被截断了，建议用以下命令跟踪完整的服务重启周期日志，找到具体的失败原因：

docker service logs -f stackapi_kong-database

通常初始化失败后会输出明确的错误提示（比如磁盘空间不足、权限拒绝等），这是定位问题最直接的方式。

内容的提问来源于stack exchange，提问作者Tara Prasad Gurung