如何从本地SpringBoot API访问Docker容器内的SpringBoot端点？

Docker相关概念澄清 #

• 主机（Host）：指运行Docker守护进程的物理/虚拟机器，也就是你安装Docker的电脑。
• 从容器连接到主机上的服务：Docker容器内的程序，访问安装Docker的机器上运行的服务（比如你本地未容器化的登录API）。
• 从主机连接到容器：安装Docker的机器上的程序（比如你的JUnit测试、本地登录API），访问Docker容器里运行的服务。
• docker host：和上面的“主机”是同一个概念，即运行Docker守护进程的那台机器。
• docker localhost：容器内部的localhost是容器自身的网络命名空间，仅指向容器本身，和主机的localhost不是同一个地址。

本地SpringBoot服务访问Docker容器内API的解决方案 #

先分析你之前尝试的错误原因 #

1. localhost报403：端口映射是通的，但注册API的接口有权限校验（比如Spring Security配置），拒绝了来自localhost的请求，或者请求缺少必要的认证信息/请求头。
2. 容器名映射到127.0.0.1报Host错误：你手动映射的Host规则无效，且注册API可能配置了Host白名单，仅允许特定Host访问，或者WebClient请求的Host头不符合要求。
3. 容器IP连接超时：Docker容器所在的网络与主机网络无法互通，或者容器内部的防火墙/安全组拦截了外部请求。
4. host.docker.internal解析失败：该域名是Docker Desktop专属的互访域名，Linux系统的Docker默认不支持，需要额外配置。

正确的解决步骤 #

1. 确认端口映射配置
   EXPOSE只是声明容器端口，不会自动完成主机与容器的端口映射，必须在docker-compose.yml中显式配置ports字段，示例：

   services:
     registration-api:
       container_name: airport_registration_container
       build: .
       ports:
         - "1993:1993"  # 格式：主机端口:容器端口
       depends_on:
         - postgres
     postgres:
       container_name: postgres_container
       image: postgres:latest
       # 补充Postgres的环境变量、数据卷等配置
   

   配置完成后，重新执行docker compose up --build，主机就可以通过localhost:1993访问容器内的服务。

2. 解决403权限问题
   既然localhost:1993能返回403，说明网络连通性没问题，问题出在注册API的权限控制：

   • 检查Spring Security配置，是否允许来自localhost的请求访问/users/admin接口；
   • 确认测试用的WebClient是否携带了接口要求的认证信息（比如Token、Cookie）；
   • 测试阶段可临时关闭注册API的权限校验，验证接口是否能正常返回数据。

3. 备选方案（端口映射失效时）

   • 使用Docker网络网关IP：通过docker inspect airport_registration_container找到容器所在网络的网关IP（通常是172.x.x.1），用该IP加容器端口访问，例如http://172.21.0.1:1993/users/admin；
   • 配置固定容器IP：在docker-compose.yml中给容器指定固定IP，确保主机能访问该网段：

     networks:
       custom-net:
         ipam:
           config:
             - subnet: 172.22.0.0/16
     services:
       registration-api:
         # 其他配置
         networks:
           custom-net:
             ipv4_address: 172.22.0.5
     

     配置后主机可直接通过http://172.22.0.5:1993/users/admin访问容器接口。

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