Docker+Django连接PostgreSQL时postgres用户认证失败求助

可能的原因及对应解决步骤 #

1. .env文件覆盖了数据库配置 #

你的web服务配置了env_file: .env，如果.env文件中存在POSTGRES_PASSWORD或Django读取的数据库密码相关环境变量（比如DATABASE_PASSWORD），且值与settings.py、docker-compose.yml里的postgres不一致，就会导致密码不匹配。

• 解决：打开.env文件，检查数据库相关环境变量，确保POSTGRES_PASSWORD（或对应Django使用的变量）的值为postgres，与其余配置保持一致；若无需环境变量配置，直接移除env_file项即可。

2. PostgreSQL数据卷残留旧配置 #

即使执行了docker-compose down -v，本地./data/db目录若未彻底删除，之前创建的PostgreSQL用户密码配置会残留，新启动的容器会复用旧数据，导致密码不匹配。

• 解决：停止所有容器后，手动删除本地数据目录，再重新启动：

  docker-compose down
  rm -rf ./data/db
  docker-compose up --build
  

3. Django配置未正确生效 #

检查settings.py中是否存在通过环境变量覆盖数据库密码的逻辑，比如：

PASSWORD = os.getenv('POSTGRES_PASSWORD', 'postgres')

如果存在此类写法，且.env中变量值错误，会导致实际使用的密码与数据库配置不一致。

• 解决：确认settings.py中的数据库密码为固定值postgres，或确保环境变量值与数据库配置完全匹配。

4. 数据库服务未完全就绪（次要可能） #

depends_on仅保证db服务优先启动，但不等待PostgreSQL完全就绪，Django可能在数据库尚未准备好时发起连接，偶尔也会触发类似密码认证失败的提示。

• 解决：在web服务启动命令前添加等待逻辑，比如使用wait-for-it脚本：
  修改docker-compose.yml中web的command：

  command: sh -c "./wait-for-it.sh db:5432 -- python manage.py runserver 0.0.0.0:8000"
  

  （需将wait-for-it.sh脚本放入项目根目录，或使用自带该工具的镜像）

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