连接拒绝：Docker化Spring Boot应用无法连接本地PostgreSQL数据库

以下是针对不同场景的排查和解决步骤：

一、先确认基础问题 #

1. 验证本地PostgreSQL本身可连接
   在主机终端执行命令测试本地连接：

   psql -h localhost -U postgres -d app
   

   如果这个命令都失败，说明PostgreSQL服务未启动、端口不对或账号密码错误，先解决本地连接问题。

2. 检查PostgreSQL服务状态

   • Linux：systemctl status postgresql
   • Windows：打开服务管理器，确认PostgreSQL服务处于运行状态
   • Mac：brew services list（若用brew安装）

二、分系统场景处理 #

场景1：Linux系统（Docker原生支持host网络） #

你已设置network_mode: host但仍连接失败，大概率是PostgreSQL的监听配置限制：

1. 修改PostgreSQL监听地址
   编辑PostgreSQL配置文件postgresql.conf（路径通常为/etc/postgresql/<版本>/main/postgresql.conf）：

   listen_addresses = '*'  # 允许监听所有网卡，默认可能仅为localhost
   

2. 配置pg_hba.conf允许本地连接
   编辑同目录下的pg_hba.conf，添加或确认存在以下规则：

   host all all 127.0.0.1/32 scram-sha-256  # 允许本地127.0.0.1连接，旧版本可替换为md5
   

3. 重启PostgreSQL服务

   systemctl restart postgresql
   

4. 检查防火墙规则
   确保主机防火墙允许5432端口的本地连接，比如用ufw：

   ufw allow 5432
   

场景2：Windows/Mac（Docker Desktop） #

Docker Desktop的network_mode: host功能受限，容器无法通过localhost直接访问主机服务，需做以下调整：

1. 修改Spring Boot数据库地址
   将application.properties中的localhost替换为host.docker.internal：

   main.jdbc.url.primary=jdbc:postgresql://host.docker.internal:5432/app
   

2. 配置PostgreSQL允许Docker网段连接
   编辑pg_hba.conf，添加Docker默认网桥网段的访问规则：

   host all all 172.17.0.0/16 scram-sha-256
   

   同时修改postgresql.conf的listen_addresses = '*'，重启PostgreSQL服务。

三、替代方案（不用host网络） #

若不想使用network_mode: host，可保持默认网桥模式，通过主机实际IP地址连接：

1. 查看主机局域网IP（Linux用ip a，Windows用ipconfig，Mac用ifconfig）
2. 修改application.properties：

   main.jdbc.url.primary=jdbc:postgresql://<主机IP>:5432/app
   

3. 确保pg_hba.conf允许该IP所在网段的连接，比如：

   host all all <主机IP>/32 scram-sha-256
   

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