使用Jdbi连接Docker中PostgreSQL数据库时密码验证失败求助

核心原因分析 #

容器内psql能无密码/任意密码登录，是因为PostgreSQL的pg_hba.conf配置了本地连接免密码认证（比如trust或peer规则），但Jdbi通过TCP/IP连接属于远程访问，会触发密码校验规则，此时如果用户密码未正确初始化或连接配置有误，就会出现验证失败。

排查与解决步骤 #

1. 检查PostgreSQL认证配置文件 #

进入容器查看pg_hba.conf：

docker exec -it <你的PostgreSQL容器名> bash
cat /var/lib/postgresql/data/pg_hba.conf

重点看针对远程IP段的规则（比如0.0.0.0/0），如果是md5或scram-sha-256，说明远程连接需要密码验证，此时必须确保用户密码正确。

2. 重置PostgreSQL用户密码 #

即使docker-compose配置了POSTGRES_PASSWORD，如果数据卷未清空，旧密码可能残留。执行以下步骤重置：

1. 容器内登录psql：psql -U dbuser -d db
2. 执行密码重置命令：

ALTER USER dbuser WITH PASSWORD 'changeit';
FLUSH PRIVILEGES;

3. 退出容器后重启：docker compose restart

如果怀疑数据卷残留，先删除对应数据卷再重建容器：

# 查看数据卷
docker volume ls
# 删除PostgreSQL数据卷（替换为你的卷名）
docker volume rm <postgres_data_volume_name>
# 重新启动容器
docker compose up --build --force-recreate

3. 核对Jdbi连接配置 #

确保连接URL或凭证配置正确：

• 方式1：URL拼接（注意转义特殊字符）

String url = "jdbc:postgresql://localhost:5432/db?user=dbuser&password=changeit";
Jdbi jdbi = Jdbi.create(url);

• 方式2：单独设置凭证（更可靠）

Jdbi jdbi = Jdbi.create("jdbc:postgresql://localhost:5432/db")
                 .withCredentials("dbuser", "changeit");

检查是否存在拼写错误、大小写问题，或密码包含特殊字符未转义。

4. 查看PostgreSQL日志定位细节 #

容器日志会给出更精准的错误原因：

docker logs <你的PostgreSQL容器名>

比如可以看到是密码哈希不匹配，还是用户不存在，帮助快速定位问题。

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