Docker-Compose环境下PostgreSQL意外关闭连接问题排查求助

• 容器网络匹配问题
  若从宿主机或其他容器连接，别用localhost作为连接地址——容器内的localhost指向自身，而非宿主机或其他服务。Docker Compose默认用自定义网络，应使用compose配置里的服务名（比如postgres）或容器IP作为连接主机。

• 端口映射未配置/冲突
  检查docker-compose.yml的ports字段，确认容器5432端口已映射到宿主机，比如ports: ["5432:5432"]。端口未映射或被其他进程占用时，外部连接会直接失败并触发断开提示。

• 容器资源不足或进程崩溃
  执行docker-compose logs <postgres服务名>查看容器日志，排查是否存在内存耗尽（OOM）、磁盘空间不足或PostgreSQL进程异常退出的情况——这些都会导致连接意外中断。

• TCP连接超时参数不合理
  检查postgresql.conf中的tcp_keepalives_idle、tcp_keepalives_interval等参数，Docker网络环境下不合理的保活设置可能触发连接被主动断开。

• pg_hba.conf缺少远程访问规则
  当前pg_hba.conf仅允许本地回路（127.0.0.1/::1）和本地socket连接。若从宿主机外部、其他子网的容器连接，需添加对应规则：

  # 允许Docker默认子网访问（示例，根据实际子网调整）
  host    all             all             172.17.0.0/16            trust
  # 测试用：允许所有远程IP（生产环境禁用）
  host    all             all             0.0.0.0/0                trust
  

• 服务启动顺序问题
  若应用容器在PostgreSQL完全就绪前发起连接，会导致连接失败。需在docker-compose.yml中配置健康检查，确保PostgreSQL就绪后再启动应用：

  services:
    postgres:
      image: postgres:latest
      healthcheck:
        test: ["CMD-SHELL", "pg_isready -U postgres"]
        interval: 5s
        timeout: 5s
        retries: 5
    app:
      build: .
      depends_on:
        postgres:
          condition: service_healthy
  

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