Docker容器内Spring应用连接Windows主机PostgreSQL报错排查

针对你的三个疑问逐一说明 #

1. application.properties中用localhost作为数据库地址完全错误
   容器内的localhost指向Spring应用所在容器自身的回环网卡，和Windows宿主机没有任何关系。另外你当前配置里把数据库地址硬编码为localhost，即使你在docker-compose里配置了DATABASE_HOST=local的环境变量，配置文件也不会读取这个变量，环境变量配置完全不生效。

2. 仅配置listen_addresses = '*'不足以放行连接
   该配置仅作用是让PostgreSQL监听本机所有网卡的连接请求，还需要两个额外配置：

• 修改PostgreSQL的pg_hba.conf访问控制文件，放行Docker所属网段的IP访问权限
• 在Windows防火墙中添加入站规则，放开5432端口的TCP连接请求，否则流量会被系统防火墙直接拦截

3. 你看到的docker0网卡IP获取命令不适用于Windows环境，且不能直接写在docker-compose.yml中

• 那条命令是Linux环境下原生Docker的用法，Windows上的Docker Desktop（不管是Hyper-V还是WSL2后端）不存在docker0网桥，执行这条命令拿不到正确的宿主机IP
• docker-compose.yml本身不支持直接内嵌执行shell命令，配置里的${IP_ADDRESS}只会读取执行docker-compose up命令时当前终端的环境变量，不会在yml文件内执行你写的shell语句
• 你之前遇到的invalid IP address in add-host报错，根源是extra_hosts配置的格式要求为自定义主机名:IP地址，你之前写的"local:host.docker.internal"把域名host.docker.internal当成IP填入，Docker无法识别这个值为合法IP，直接抛出错误。

可直接落地的修复步骤 #

1. 修改Spring配置文件，让数据库地址读取环境变量
   把application.properties中的数据库连接URL替换为以下配置，优先读取docker-compose传入的环境变量：

## PostgreSQL
spring.datasource.driver-class-name=org.postgresql.Driver
spring.datasource.url=jdbc:postgresql://${DATABASE_HOST:host.docker.internal}:${DATABASE_PORT:5432}/${DATABASE_NAME:psqldb}
spring.datasource.username=user
spring.datasource.password=******

2. 修正docker-compose.yml配置
   Windows版Docker Desktop 20.04及以上版本已经内置了host.docker.internal域名的自动解析，会直接指向Windows宿主机，不需要手动配置extra_hosts，修正后的配置如下：

version: '3.8'

services:
  spring-app-container:
    image: spring-app:1
    build:
      context: ./
      dockerfile: Dockerfile
    ports:
      - "50800:50800"
    environment:
      - DATABASE_HOST=host.docker.internal
      - DATABASE_USER=user
      - DATABASE_PASSWORD=********
      - DATABASE_NAME=psqldb
      - DATABASE_PORT=5432

如果你使用的是低于20.04的老版本Docker Desktop，直接手动查询Windows上vEthernet (DockerNAT)（Hyper-V后端）或vEthernet (WSL)（WSL2后端）网卡的IP，把IP填到extra_hosts里即可，格式参考：extra_hosts: ["local:你查到的宿主机IP"]，同时把DATABASE_HOST改为local

3. 配置PostgreSQL放行规则

• 确认postgresql.conf中listen_addresses = '*'配置已保存，重启PostgreSQL服务让配置生效
• 打开PostgreSQL数据目录下的pg_hba.conf文件，添加一行访问规则放行Docker网段，测试阶段可以先加全量放行规则验证连通性，验证通过后再缩窄IP范围避免安全风险：

host    all             all             0.0.0.0/0            md5

添加后重启PostgreSQL服务

• 打开Windows Defender防火墙高级设置，新建5432端口的TCP入站规则，允许专用网络下的连接请求

4. 连通性验证
   启动容器后先进入容器内部，执行ping host.docker.internal和telnet host.docker.internal 5432验证网络连通，确认能通之后再启动Spring应用即可。

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