Docker部署Spring Boot无法连接Spring Cloud Config Server问题

该问题由Docker默认的网络隔离机制导致，和Spring Boot/Cloud的业务配置本身无关：

• 本地直接启动服务时，两个服务共享宿主机的网络命名空间，服务内配置的localhost直接指向宿主机，因此业务服务访问localhost:8888可以正常命中同主机上启动的配置中心服务。
• 容器化部署时，每个未做特殊网络配置的Docker容器都拥有独立的网络栈，容器内部的localhost仅指向容器自身，不会指向宿主机或其他容器。业务服务容器内部没有运行8888端口的服务，因此访问localhost:8888必然抛出连接拒绝错误，后续因拉取不到配置出现数据源缺失url的报错。
• 宿主机可以通过http://localhost:8888正常访问配置中心，是因为启动配置中心时添加了-p 8888:8888端口映射规则，该规则仅对宿主机侧生效，独立启动的其他容器默认无法通过宿主机的localhost访问到这个映射端口。

根据部署场景选择以下任意一种方案即可：

方案1：使用宿主机网络（适合本地快速验证） #

启动业务服务容器时直接指定复用宿主机网络栈，此时容器内的localhost和宿主机的localhost指向完全一致，不需要修改原有业务配置。
启动命令调整为：

docker run --network host -p 8000:8000 eveningstar33/mmv2-currency-exchange-service:0.0.1-SNAPSHOT

注意：该方案仅在Linux宿主机上可直接生效，Windows/macOS环境下的Docker Desktop对host网络的支持存在兼容差异，优先选择方案2。

方案2：自定义Docker桥接网络（推荐常规部署使用） #

创建自定义桥接网络，将两个容器都接入该网络，容器之间可以直接通过容器名作为域名互相访问，不需要依赖宿主机端口映射，稳定性更高。
操作步骤：

1. 创建自定义桥接网络

   docker network create microservice-net
   

2. 启动配置中心容器，指定接入的网络、设置容器名，保留端口映射方便宿主机本地调试

   docker run -d --network microservice-net --name config-server -p 8888:8888 eveningstar33/mmv2-spring-cloud-config-server:0.0.1-SNAPSHOT
   

3. 调整业务服务中配置中心的连接地址，将原有配置里的localhost替换为配置中心的容器名config-server，核心配置片段如下：

   spring:
     config:
       import: optional:configserver:http://config-server:8888
     cloud:
       config:
         label: master
         uri: http://config-server:8888
         username: gigi
         password: test1234
   

4. 重新构建业务服务镜像，启动时接入同一个自定义网络即可

   docker run -d --network microservice-net -p 8000:8000 eveningstar33/mmv2-currency-exchange-service:0.0.1-SNAPSHOT
   

补充：如果不想修改配置重新构建镜像，也可以在启动业务服务容器时通过Spring Boot支持的环境变量直接覆盖配置中心地址，命令如下：

docker run -d --network microservice-net -p 8000:8000 \
  -e SPRING_CLOUD_CONFIG_URI=http://config-server:8888 \
  -e SPRING_CONFIG_IMPORT=optional:configserver:http://config-server:8888 \
  eveningstar33/mmv2-currency-exchange-service:0.0.1-SNAPSHOT

方案3：使用宿主机实际IP访问（不推荐生产使用） #

如果不想调整网络配置，也可以将业务服务配置里的配置中心地址从localhost替换为宿主机的物理网卡IP，或者Docker默认桥接网络的网关IP（通常为172.17.0.1）。但该IP会随宿主机网络环境变化，稳定性差，仅适合临时调试使用。

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