Docker中PostgreSQL无法通过配置的账号密码连接问题

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

1. 容器初始化缓存导致环境变量未生效 #

PostgreSQL容器仅在首次创建并挂载空数据卷时才会执行初始化（创建指定用户、数据库）。如果之前启动过容器，即使修改了docker-compose.yml的环境变量，旧的数据库数据卷仍会保留，新配置不会生效。

解决：
删除现有容器及关联数据卷，重新初始化：

docker-compose down -v
docker-compose up -d

-v 参数会删除容器绑定的数据卷，确保下次启动时PostgreSQL重新执行初始化流程，应用新的POSTGRES_USER/POSTGRES_PASSWORD配置。

2. 本地PostgreSQL服务占用5432端口 #

如果本地主机已经运行了PostgreSQL服务，Docker映射的5432:5432端口会被本地服务抢占，导致你的代码实际上连接到了本地的PostgreSQL（而非Docker容器内的），而本地服务可能存在名为username的用户或认证配置不同。

解决：

• 检查端口占用：

  lsof -i :5432
  

• 若发现本地PostgreSQL进程，停止本地服务；或修改Docker Compose的端口映射，比如改为：

  ports:
    - "5433:5432"
  

  同时更新SQLAlchemy连接串为：

  "postgresql+psycopg2://postgres:postgres@localhost:5433/voting"
  

3. 代码中连接串被覆盖 #

你的create_tables函数可能内部读取了环境变量（如DB_USER、DB_PASSWORD）或默认值，导致传入的连接串参数被篡改，实际使用了username作为用户。

解决：
在create_tables函数中添加打印，确认实际使用的连接串：

def create_tables(conn_str):
    print(f"实际使用的连接串: {conn_str}")
    # 后续创建引擎的逻辑

如果打印结果与传入的不符，检查函数内部是否有覆盖连接参数的逻辑。

4. 验证容器内的PostgreSQL配置 #

进入容器直接检查用户和数据库是否正确创建：

docker exec -it postgres psql -U postgres

在PostgreSQL命令行中执行：

-- 检查用户列表
SELECT usename FROM pg_user;
-- 检查数据库列表
SELECT datname FROM pg_database;

确认输出中存在postgres用户和voting数据库。

内容的提问来源于stack exchange，提问作者The one who doesn't know 1012