Docker容器化SpringBoot应用无法连接本地非容器化PostgreSQL数据库

容器内的localhost指向的是容器自身的环回地址，而非宿主机地址。你在Eclipse中运行应用时，应用直接部署在宿主机上，localhost可以正常访问本地部署的PostgreSQL，因此不存在问题。容器内应用完全可以访问未容器化的数据库，仅需调整配置即可。

以下3种方案任选其一即可：

方案1：修改数据库连接地址（兼容性最好，全平台适用） #

• 先获取宿主机对应的访问地址：
  • Linux环境：执行ip addr show docker0查看docker0网卡的IP，默认一般为172.17.0.1，以实际查询结果为准
  • Windows/Mac Docker Desktop环境：直接使用Docker内置的宿主机域名host.docker.internal
• 修改application.yml中的数据库连接地址，将localhost替换为上述地址，示例：

  # Linux环境示例
  url: jdbc:postgresql://172.17.0.1:5432/permisosdb
  # Windows/Mac环境示例
  url: jdbc:postgresql://host.docker.internal:5432/permisosdb
  

• 额外校验配置：
  • 检查PostgreSQL的postgresql.conf中listen_addresses配置为*或包含Docker网卡网段
  • 检查PostgreSQL的pg_hba.conf中已添加Docker网段的访问授权，示例配置：host all all 172.17.0.0/16 scram-sha-256（网段根据实际Docker配置调整）
  • 确认宿主机防火墙未拦截5432端口的访问请求

方案2：启动容器时使用host网络模式（仅Linux适用） #

Linux环境下Docker支持host网络模式，容器会直接共享宿主机的网络栈，此时容器内的localhost和宿主机完全一致，无需修改任何应用配置：

• 启动容器时添加--net=host参数即可：

  docker run -d --net=host --name permisos-app <你的镜像名称>
  

• 注意：Windows/Mac的Docker Desktop基于虚拟化实现，host网络模式存在兼容问题，不推荐使用该方案。

方案3：使用自定义Docker网络（适合后续计划容器化数据库的场景） #

如果后续有将PostgreSQL容器化的规划，可以提前创建自定义Docker网络，应用容器和数据库容器加入同一网络后，可直接通过容器名作为域名互相访问。如果数据库长期使用宿主机部署，优先选择前两种方案。

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