Docker容器PostgreSQL第三方工具连接认证失败求助

问题背景 #

在Docker Desktop多容器环境中部署PostgreSQL，终端查看数据格式混乱，使用DBeaver、pgcli等工具连接时，始终报错：FATAL: password authentication failed for user "rasa"。已确认端口、数据库名、用户名、密码与docker-compose.yml配置一致，Docker终端可正常连接，且执行过修改pg_hba.conf、重置密码、重建容器等操作仍无效。

解决步骤 #

1. 确保PostgreSQL允许外部连接 #

进入PostgreSQL容器，编辑postgresql.conf（路径通常为/var/lib/postgresql/data/postgresql.conf），将listen_addresses设置为'*'：

docker exec -it <你的postgres容器名> bash
vi /var/lib/postgresql/data/postgresql.conf

找到listen_addresses项修改后保存，重启容器：

docker-compose restart postgres

2. 修正pg_hba.conf的访问规则 #

在pg_hba.conf中添加针对外部IP的认证规则，确保主机能以md5方式访问：

# 允许所有IP的rasa用户连接所有数据库，使用md5认证
host    all             rasa            0.0.0.0/0               md5

修改后重启PostgreSQL服务或容器。

3. 强制同步用户密码哈希 #

容器内的密码哈希可能存在不一致，直接在容器内的psql中重置密码：

docker exec -it <你的postgres容器名> psql -U postgres
ALTER USER rasa WITH PASSWORD '你的docker-compose里配置的密码';
\q

之后重启容器。

4. 检查本地端口占用 #

确认映射的本地端口（如5432）未被其他进程占用：

# Windows命令行执行
netstat -ano | findstr :5432

若被占用，修改docker-compose.yml中的端口映射（例如改为5433:5432），再重建容器。

5. DBeaver连接细节排查 #

• 确认连接配置的端口是本地映射端口（而非容器内部的5432）
• 关闭"使用SSPI认证"选项
• 手动输入密码，避免自动填充导致的字符编码问题

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