Docker Compose环境下应用容器无法连接PostgreSQL问题排查

安全阿岳

2026-5-29

问题分析与解决方案

首先来看你问的第一个问题：环境变量与数据库连接配置

你当前settings.py里把数据库host设为0.0.0.0，这是核心错误。在Docker Compose的默认网络环境中，容器之间是通过服务名称来互相访问的，而不是用0.0.0.0或者localhost。你的数据库服务名叫db，所以Flask应用应该把连接的目标主机指向db，而不是0.0.0.0。

具体修改方案二选一即可：

直接修改settings.py里的POSTGRES['host']为'db'；
在docker-compose.yml的app服务中添加环境变量，覆盖IP的值：
```
app:
  # 其他原有配置...
  environment:
    - IP=db
```

为什么0.0.0.0不行？因为0.0.0.0通常用来表示“监听所有网卡”，是服务端的配置参数，但作为客户端的连接地址时，它不是一个有效的目标主机。在容器内部，0.0.0.0会指向当前app容器自身，自然连不上Postgres容器。

另外补充一个小细节：你的SQLALCHEMY_DATABASE_URI里密码部分多了个反斜杠\%(pw)s，应该改成%(pw)s，否则反斜杠会被带入连接字符串，可能导致后续认证失败。

第二个问题：是否需要为数据库指定卷？

答案是非常建议，生产环境更是必须，原因如下：

Docker容器的文件系统是临时挂载的，当你删除db容器（比如执行docker-compose down），容器内部存储的Postgres数据会被一并删除；
挂载卷可以将Postgres的数据目录/var/lib/postgresql/data映射到宿主机或者Docker命名卷中，实现数据持久化——即使容器被销毁，数据依然能保留下来。

修改docker-compose.yml的db服务，添加卷配置（推荐用Docker命名卷，管理更省心）：

db:
  image: postgres:10
  restart: always
  container_name: my_app_db_1
  environment:
    POSTGRES_USER: ubuntu
    POSTGRES_PASSWORD: pickles
    POSTGRES_DB: db
  ports:
    - 5432:5432
  volumes:
    - postgres_data:/var/lib/postgresql/data/  # 使用命名卷

# 在compose文件末尾添加volumes定义块
volumes:
  postgres_data:

如果你想把数据映射到宿主机的特定目录，也可以用绑定挂载：

volumes:
  - /Users/sammy/Projects/my_flask_app/postgres_data:/var/lib/postgresql/data/

不过命名卷由Docker统一管理，权限兼容性更好，更推荐使用。

额外提示：关于depends_on的局限性
你已经配置了depends_on: [db]，但这个配置只是保证db容器在app容器之前启动，不保证Postgres服务已经完全就绪。有时候Postgres容器启动了，但内部服务还在初始化，这时候Flask app连接还是会失败。解决这个问题可以给app的启动命令加个等待逻辑，比如用Postgres自带的pg_isready命令：

修改app服务的entrypoint：

entrypoint: ["/bin/sh", "-c", "until pg_isready -h db -p 5432; do sleep 1; done; python manage.py runserver"]

这样app会一直等待，直到Postgres服务完全就绪后才启动。

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