无法从IntelliJ IDEA连接Docker中PostgreSQL的问题排查

核心原因 #

PostgreSQL Docker镜像只会在第一次启动且数据目录为空时，执行POSTGRES_PASSWORD这类环境变量来初始化密码、用户等配置。如果之前已经创建过同名容器，或者挂载了包含旧数据的本地卷，再次启动时会直接跳过初始化流程，沿用旧的默认密码（也就是postgres）。

另外，你通过docker exec进入容器后无需密码就能连接，是因为容器内PostgreSQL启用了peer认证：当系统用户postgres本地连接时，会直接信任身份，无需输入密码，但远程工具（比如IntelliJ IDEA）用的是密码认证，所以必须用正确的初始化密码才能连接。

解决步骤 #

1. 停止并删除现有容器

docker stop localpostgres
docker rm localpostgres

2. 清理旧数据卷（关键步骤）
   先查看所有Docker卷，找到和postgres相关的卷：

docker volume ls

找到类似postgres_data或对应容器关联的卷后，删除它：

docker volume rm <卷名称>

3. 重新创建容器
   执行启动命令，这次会触发全新的初始化流程，POSTGRES_PASSWORD=pg12345会生效：

docker run --name localpostgres -e POSTGRES_PASSWORD=pg12345 -p 5432:5432 -d postgres

验证密码是否生效 #

进入容器后，强制要求输入密码连接：

docker exec -it localpostgres /bin/bash
psql -U postgres -W

此时输入pg12345就能成功连接，之后在IntelliJ IDEA里用这个密码测试连接即可成功。

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