尝试连接本地Docker PostgreSQL时遭遇密码认证失败问题

常见原因与修复方案 #

1. 清理残留容器，重新启动 #

旧容器缓存可能导致密码环境变量未正确加载，先清理再重新创建：

• 停止并删除现有PostgreSQL容器：

  docker stop $(docker ps -q --filter ancestor=postgres)
  docker rm $(docker ps -aq --filter ancestor=postgres)
  

• 重新启动容器，指定容器名方便管理：

  docker run -e POSTGRES_PASSWORD=123 -d -p 5432:5432 --name postgres-local postgres
  

2. 检查端口是否被本地PostgreSQL占用 #

如果本地机器已安装PostgreSQL，会占用5432端口，导致你连接的是本地服务而非Docker容器：

• 查看端口占用情况：

  # Linux/macOS
  lsof -i :5432
  # Windows
  netstat -ano | findstr :5432
  

• 处理方式：
  • 停止本地PostgreSQL服务，再重新连接Docker容器；
  • 或者修改Docker端口映射，比如改为-p 5433:5432，连接时使用5433端口：

    psql -h localhost -p 5433 -U postgres
    

3. 验证容器内部连接是否正常 #

先确认容器内的PostgreSQL配置没问题：

• 进入容器内部直接连接：

  docker exec -it postgres-local psql -U postgres
  

  输入密码123，如果能成功登录，说明容器内配置正常，问题出在外部连接的网络或端口映射。

4. 调整PostgreSQL认证策略 #

部分情况下，容器内的认证规则可能限制外部连接：

• 进入容器修改pg_hba.conf，允许外部密码认证：

  docker exec -it postgres-local bash
  echo "host all all 0.0.0.0/0 scram-sha-256" >> /var/lib/postgresql/data/pg_hba.conf
  

• 重启容器使配置生效：

  docker restart postgres-local
  

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