为何Docker Compose下Python连接PostgreSQL被拒？如何解决？

云上老周

2026-10-29

问题根因

两个核心问题导致Python脚本无法连接数据库：

连接地址配置错误：脚本里用127.0.0.1作为数据库主机地址，在Docker容器的运行语境下，这个地址指向app容器自身的回环网络，根本无法访问旁边独立运行的db容器。Docker Compose会为同项目下的所有服务自动创建内部互通网络，服务名称本身就可以作为主机名，被同网络下的其他服务直接访问。
启动时序不匹配：app和db容器是并行启动的，哪怕地址配置正确，只要Postgres还没完成初始化、没开始监听5432端口，app脚本就发起连接请求，依然会触发连接拒绝的报错。

具体解决步骤

修改Python脚本的数据库连接字符串
把脚本里写死的127.0.0.1替换为docker-compose中定义的数据库服务名db，例如原连接配置为：
postgresql://数据库用户名:数据库密码@127.0.0.1:5432/数据库名
修改为：
postgresql://数据库用户名:数据库密码@db:5432/数据库名
注意：服务间内部通信不需要把db的5432端口映射到宿主机。
调整docker-compose.yml配置，解决启动时序问题
在app服务下添加启动依赖和等待逻辑，避免app抢在Postgres完全就绪前启动：
```
version: "3.6"
services:
  app:
    build: ./app/
    depends_on:
      - db
    # 检测db的5432端口可连通后，再启动Python脚本
    command: sh -c "until nc -z db 5432; do echo '等待数据库服务就绪...'; sleep 1; done && python abc.py"
  db:
    build: ./database/
```
补充说明：depends_on仅会保证db容器比app容器先启动，不会等待Postgres完成初始化监听，因此上述until端口检测的逻辑是必要的。
重新启动服务验证
执行docker-compose up --build重新构建并启动服务，原先的连接拒绝报错就会消失。如果需要排查网络连通性，可以进入app容器执行nc -vz db 5432，返回连接成功即说明配置正确。