我来帮你一步步排查这个连接故障，从你的配置和报错信息来看，主要有几个关键环节需要检查：

1. 确认容器处于同一Docker网络 #

Docker Compose默认会给项目下的所有服务创建一个专属网络，服务名（比如due_database）应该能直接在这个网络里被解析。但如果网络配置异常，就会出现解析失败或连接拒绝的问题：

• 执行以下命令检查两个容器的网络归属：

  docker inspect due | grep Networks
  docker inspect due_database | grep Networks
  

  确保两者显示的网络名称一致（默认是你的项目名_default）。
• 如果不在同一网络，要么恢复默认网络配置，要么在docker-compose.yml中显式定义共享网络：

  version: '2.1'
  networks:
    due-shared-network:
      driver: bridge
  services:
    due:
      # 其他配置不变
      networks:
        - due-shared-network
    due_database:
      # 其他配置不变
      networks:
        - due-shared-network
  

2. 检查PostgreSQL的监听地址配置 #

官方PostgreSQL镜像默认应该监听所有地址，但偶尔会出现配置异常，导致只允许本地连接：

• 进入数据库容器验证监听配置：

  docker exec -it due_database bash
  cat /var/lib/postgresql/data/postgresql.conf | grep listen_addresses
  

  确保输出是listen_addresses = '*'（允许所有IP连接）。
• 如果不是这个值，可以挂载自定义的postgresql.conf到容器中：

  due_database:
    # 其他配置不变
    volumes:
      - ./.dueutil_db:/var/lib/postgresql/data
      - ./custom-postgresql.conf:/var/lib/postgresql/data/postgresql.conf
  

  在custom-postgresql.conf中添加listen_addresses = '*'即可。

3. 修正数据库健康检查的有效性 #

你当前的健康检查命令pg_isready -U postgres默认只检查本地连接，就算通过了，也不代表外部容器能连接上。建议修改为：

healthcheck:
  test: ["CMD-SHELL", "pg_isready -U postgres -h 0.0.0.0"]
  interval: 10s
  timeout: 5s
  retries: 5

然后执行docker ps查看due_database的状态，确保它显示为healthy后，再启动应用容器。

4. 在应用容器内直接测试连接 #

进入应用容器手动测试数据库连接，能更精准定位问题：

• 先进入应用容器：

  docker exec -it due bash
  

• 如果容器内没有psql客户端，先安装（以Debian/Ubuntu为例）：

  apt-get update && apt-get install -y postgresql-client
  

• 执行连接命令测试：

  psql -U postgres -h due_database -p 5432 postgres
  

  如果还是连接拒绝，看具体报错：
  • 若提示主机名解析失败：回到第一步检查网络配置；
  • 若提示端口无法连接：检查PostgreSQL的监听地址和容器端口是否正常。

5. 排除端口占用或防火墙干扰 #

• 主机上如果运行了本地PostgreSQL服务，可能会占用5432端口，但容器间连接用的是容器内部端口，所以这个不影响容器间通信，但可以通过docker logs due_database查看是否有端口绑定失败的日志。
• 确保主机防火墙没有阻止Docker容器间的通信（大多数情况下默认是允许的，但可以临时关闭防火墙测试）。

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