SQLAlchemy/pgAdmin报错：用户‘root’密码认证失败求助

以下是针对你的场景的分步解决方案：

1. 适配psycopg2与PostgreSQL加密方式 #

psycopg2 2.7.x版本不支持PostgreSQL 10+默认的scram-sha-256加密格式，这是最常见的验证失败原因：

• 进入Postgres容器：

  docker exec -it <你的postgres容器名称> bash
  

• 编辑pg_hba.conf文件（路径通常为/var/lib/postgresql/data/pg_hba.conf），将对应连接规则的scram-sha-256改为md5：

  # 示例修改（允许所有IP以md5验证连接）
  host    all             all             0.0.0.0/0               md5
  

• 重启Postgres容器生效：

  docker-compose restart postgres
  

2. 重置root用户密码为md5格式 #

即使修改了配置，已存在的用户密码仍可能是scram加密，需重新设置：

• 进入psql控制台：

  docker exec -it <你的postgres容器名称> psql -U postgres
  

• 执行SQL重置密码：

  ALTER USER root WITH PASSWORD 'root' ENCRYPTED WITH md5_password;
  

• 退出psql：\q

3. 确认SQLAlchemy连接字符串正确性 #

确保连接参数完全匹配你的部署配置：

# 示例连接字符串（端口需与docker-compose.yml中的映射一致）
db_url = "postgresql://root:root@localhost:5432/materials"

• 检查端口：如果docker-compose.yml中Postgres端口映射为5433:5432，则连接字符串端口改为5433
• 检查主机：本地环境使用localhost或127.0.0.1，不要使用容器内部IP

4. 验证用户登录权限 #

在pgAdmin中确认root用户已勾选**"Can login"**选项，无此权限会直接导致登录失败。

5. 检查版本兼容性 #

psycopg2 2.7.3.1仅支持PostgreSQL 9.1~10版本，若你的Docker Postgres版本过高（如12+），会出现兼容性问题：

• 查看Postgres版本：

  docker exec <你的postgres容器名称> psql -U postgres -c "SELECT version();"
  

• 版本过高时的解决方式：
  • 降级Docker Postgres到10版本（修改docker-compose.yml中的image为postgres:10）
  • 在Python2.7环境升级psycopg2到最高兼容版本2.8.6：

    pip install psycopg2==2.8.6
    

6. 测试网络连通性 #

确认Python环境能访问Postgres容器的端口：

telnet localhost 5432
# 或用nc命令
nc -zv localhost 5432

若无法连通，检查docker-compose.yml中的端口映射配置是否正确。

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