Docker容器无法连接本地PostgreSQL数据库的问题求助

核心问题在于Docker容器内的localhost指向容器自身的网络空间，而非宿主机，所以你的Spring Boot应用在容器里尝试连接localhost:5432时，其实是在找容器内部的PostgreSQL，自然会被拒绝。

下面是三种可行的解决方法，按推荐程度排序：

方法1：使用宿主机的实际IP地址（通用且稳定） #

1. 获取宿主机IP：

   • Windows：打开命令提示符执行ipconfig，找到局域网IPv4地址（比如192.168.1.100）
   • Linux/macOS：执行ifconfig或ip addr，找到对应网卡的IP

2. 修改Spring Boot配置：
   编辑application.properties，把数据库URL里的localhost替换成宿主机IP：

   spring.datasource.url=jdbc:postgresql://192.168.1.100:5432/postgres
   

3. 允许PostgreSQL接收该IP的连接：
   编辑PostgreSQL的pg_hba.conf文件（通常在data目录下），添加一行：

   host all all 192.168.1.0/24 md5
   

   （把192.168.1.0/24换成你宿主机所在的IP段，或者用0.0.0.0/0允许所有IP，仅限开发环境）

4. 重启PostgreSQL服务，确保配置生效。

方法2：使用Docker Host网络模式（开发环境快速解决） #

启动容器时直接使用宿主机的网络命名空间，这样容器内的localhost就等同于宿主机的localhost：

docker run --network=host test:latest

注意：这种模式下容器会直接使用宿主机的端口，无需再用-p映射端口，且容器端口会和宿主机端口冲突，仅适合开发调试。

方法3：修正你的容器启动命令（原命令有误） #

你之前的启动命令docker run --network=test:latest是错误的，--network参数后应该跟网络名称而非镜像名，正确的桥接模式启动命令是：

docker run -p 8080:8080 test:latest

（桥接模式是Docker默认网络，加上-p映射端口方便访问应用）

额外检查点 #

• 确认PostgreSQL的listen_addresses = '*'已经生效（你已经设置，但需确保服务已重启）
• 宿主机防火墙需开放5432端口的入站连接，除了Docker Desktop，还要手动添加PostgreSQL的端口规则
• 测试宿主机IP的连通性：在容器内执行ping <宿主机IP>或telnet <宿主机IP> 5432，确认网络可达

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