Docker部署PostgreSQL后Spring应用连接失败求助

核心排查与修复步骤 #

1. 替换容器IP为本地映射地址 #

你已经配置了端口映射 -p 5432:5432，完全无需使用容器内部IP连接。直接修改application.properties中的数据库URL：

spring.datasource.url=jdbc:postgresql://localhost:5432/userdb
# 也可使用127.0.0.1替代localhost
# spring.datasource.url=jdbc:postgresql://127.0.0.1:5432/userdb

容器IP会随重启变化，而本地端口映射是固定的，这是更可靠的连接方式。

2. 验证PostgreSQL容器状态 #

先确认容器是否正常运行：

docker ps

如果容器未运行，查看日志排查启动失败原因：

docker logs postgres_con

若日志出现权限相关错误（比如Windows挂载卷时的权限冲突），可暂时移除卷挂载参数重新启动容器测试：

docker stop postgres_con
docker rm postgres_con
docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=admin -e POSTGRES_USER=admin -e POSTGRES_DB=userdb --name=postgres_con postgres

3. 检查本地防火墙/安全软件 #

Windows防火墙可能拦截5432端口的通信，临时关闭防火墙后重试连接，确认是否为防火墙导致的问题。

4. 验证PostgreSQL服务可用性 #

进入容器内部，用psql直接连接验证服务状态：

docker exec -it postgres_con psql -U admin -d userdb

如果能正常进入数据库，说明PostgreSQL服务本身无问题，问题出在Spring应用的配置或网络连通性上。

5. 核对驱动版本兼容性 #

确保Spring项目中PostgreSQL驱动版本与容器内的PostgreSQL版本兼容。若容器拉取的是最新版PostgreSQL，建议使用对应兼容的驱动版本（比如升级postgresql依赖至最新稳定版）。

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