Docker容器中本地PostgreSQL数据库密码认证失败求助

针对你遇到的password authentication failed for user "root"错误，按以下步骤排查解决：

• 验证Docker容器的PostgreSQL配置
  首先确认启动容器时是否正确设置了用户和密码的环境变量。官方Postgres镜像默认用户是postgres，如果要使用root用户，必须在启动容器时指定POSTGRES_USER=root：

  docker run -d -p 5432:5432 \
    -e POSTGRES_USER=root \
    -e POSTGRES_PASSWORD=你的密码 \
    -e POSTGRES_DB=目标数据库名 \
    --name postgres-db postgres
  

  可以进入容器直接测试登录：

  docker exec -it postgres-db psql -U root -d 目标数据库名
  

  如果这里登录失败，说明容器内的用户密码配置错误，需要重新创建容器并设置正确的环境变量。

• 检查连接字符串参数
  打印你的连接字符串确认参数是否正确：

  user = "root"
  password = "你的密码"
  host = "localhost"
  port = "5432"
  dbname = "目标数据库名"
  print(f"postgresql://{user}:{password}@{host}:{port}/{dbname}")
  

  重点注意：

  • 端口是否和容器映射的宿主机端口一致（如果容器端口不是5432映射到宿主机5432，要修改对应的值）
  • 密码如果包含特殊字符（如@、#、&），需要进行URL编码，比如@换成%40，#换成%23

• 检查PostgreSQL的访问控制配置
  进入容器查看pg_hba.conf文件，确认是否允许宿主机通过密码验证连接：

  docker exec -it postgres-db cat /var/lib/postgresql/data/pg_hba.conf
  

  确保存在类似以下的配置行：

  host    all             all             0.0.0.0/0               md5
  host    all             all             ::/0                    md5
  

  官方镜像默认已经配置了允许远程md5验证，这一步一般无需修改，除非你自定义了配置。

• 重新测试连接
  确认以上配置都正确后，再运行你的SQLAlchemy代码测试：

  from sqlalchemy import create_engine
  user = "root"
  password = "你的密码"
  host = "localhost"
  port = "5432"
  dbname = "目标数据库名"
  engine = create_engine(f"postgresql://{user}:{password}@{host}:{port}/{dbname}", echo_pool="debug")
  con = engine.connect()
  print("连接成功")
  

内容的提问来源于stack exchange，提问作者Joel Funom Joshua