Docker化PostgreSQL密码验证失败：未设密码但默认值无效

核心规则先明确 #

官方PostgreSQL Docker镜像没有固定默认密码：

• 若启动时未指定POSTGRES_PASSWORD环境变量，容器会自动生成随机密码并输出到日志；
• 若之前启动过容器且挂载了数据卷，旧数据卷会保留已有的密码配置，后续启动会忽略新的环境变量设置。

排查步骤 #

1. 检查vars.env配置文件
   打开该文件，查看是否存在POSTGRES_PASSWORD字段。如果有，reader.py里的密码必须和这个字段的值完全一致，不能硬编码成"postgres"。

2. 查看PostgreSQL容器日志
   执行命令：

   docker-compose logs psql
   

   若启动时未指定密码，日志中会出现类似如下的行：

   LOG:  database system is ready to accept connections
   HINT:  Password for user "postgres" is "xxxxxxxxxxxx".
   

   这里的字符串就是自动生成的密码，替换reader.py里的密码即可。

3. 检查database/目录下的Dockerfile
   查看是否有设置密码的指令，比如：

   ENV POSTGRES_PASSWORD=mycustompassword
   

   或者通过RUN命令手动修改了postgres用户密码，这类配置会直接决定数据库的连接密码。

4. 清理遗留数据卷
   如果之前启动过postgres容器，旧数据卷可能保留了历史密码配置。执行以下命令彻底清理后重新构建：

   docker-compose down -v
   docker-compose up --build
   

   这会重新初始化数据库，使用当前环境变量设置密码。

优化建议（避免硬编码） #

修改reader.py直接读取环境变量，确保和数据库配置一致：

import os
import psycopg2

connection = psycopg2.connect(
    database=os.getenv("POSTGRES_DB", "postgres"),
    user=os.getenv("POSTGRES_USER", "postgres"),
    password=os.getenv("POSTGRES_PASSWORD"),
    host="psql",
    port=5432)

cursor = connection.cursor()

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