Docker部署Spring Cloud客户端无法获取Config Server配置求助

环境信息 #

1. Config Server（已Docker化并正常运行） #

标注@EnableConfigServer，基于外部Git仓库存储配置。

application.properties配置

server.port=9090
#spring.cloud.config.server.native.searchLocations=file:///${user.home}/MicroService/centralProperties/
#spring.cloud.config.server.native.searchLocations=file:///C:/PERSONAL/JAVA_PERSONAL_WORKSPACE/SpringWorkSpace2018/MicroserviceConfigServer/MicroService/centralProperties
spring.cloud.config.server.git.uri=https://github.com/myRepo/SpringCloudConfigProperties.git
#SPRING_PROFILES_ACTIVE=native

#Verify any repository issue in service startup
spring.cloud.config.server.git.cloneOnStart=true
 
#Disable security of the Management end point
management.security.enabled=false

Dockerfile

# Start with a base image containing Java runtime
FROM openjdk:8

# Add Maintainer Info
LABEL maintainer="santanuguha2006@gmail.com"

# Add the application's jar to the container
COPY target/spring-cloud-config-server.jar /opt/spring-cloud-config-server/

WORKDIR /opt/spring-cloud-config-server/

#RUN mvn package

#VOLUME /config-files

#WORKDIR /
# Make port 8085 available to the world outside this container
EXPOSE 9090
# Run the jar file
#ENTRYPOINT ["java","-jar","*******.jar"]
ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar",\
            "/opt/spring-cloud-config-server/spring-cloud-config-server.jar",\
            "--server.port=9090",\
            "--spring.config.name=spring-cloud-config-server"]

2. Config客户端应用 #

本地Spring Boot运行正常，Docker化启动后无法获取配置。

bootstrap.yml配置

server:
  port: 8787
spring:
  application:
    name: CloudClient
  cloud:
    config:
      uri: http://localhost:9090

Dockerfile

# Start with a base image containing Java runtime
FROM openjdk:8

# Add Maintainer Info
LABEL maintainer="santanuguha2006@gmail.com"

# Add the application's jar to the container
COPY target/CloudConfig-0.0.1-SNAPSHOT.jar /opt/spring-cloud-config-api/

WORKDIR /opt/spring-cloud-config-api/

#RUN mvn package

#VOLUME /config-files

#WORKDIR /
# Make port 8787 available to the world outside this container
EXPOSE 8787
# Run the jar file
#ENTRYPOINT ["java","-jar","*******.jar"]
ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar",\
            "/opt/spring-cloud-config-api/CloudConfig-0.0.1-SNAPSHOT.jar",\
            "--server.port=8787",\
            "--spring.config.name=spring-cloud-config-api"]

问题现象 #

客户端本地运行时，可通过@Value正常拉取外部配置；Docker化启动时报错：

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'scopedTarget.cloudControllerPropertiesFetch': Injection of autowired dependencies failed; nested exception is java.lang.IllegalArgumentException: Could not resolve placeholder 'spring.datasource.url' in value "${spring.datasource.url}"

排查与解决步骤 #

1. 修复容器网络连通问题（核心原因） #

Docker容器使用独立网络栈，客户端容器内的localhost指向自身，而非宿主机的Config Server，导致无法连接配置中心。

方案一：使用宿主机IP访问

修改客户端bootstrap.yml中的配置中心地址为宿主机实际IP（如192.168.1.100）：

spring:
  cloud:
    config:
      uri: http://192.168.1.100:9090

或启动容器时通过环境变量临时覆盖：

docker run -e "spring.cloud.config.uri=http://宿主机IP:9090" 客户端镜像名

方案二：使用自定义Docker网络

创建统一网络，让两个容器通过容器名互相访问：

1. 创建自定义网络：

   docker network create spring-cloud-net
   

2. 启动Config Server时加入该网络：

   docker run --name config-server --network spring-cloud-net -p 9090:9090 config-server镜像名
   

3. 修改客户端bootstrap.yml地址为容器名：

   spring:
     cloud:
       config:
         uri: http://config-server:9090
   

4. 启动客户端容器时加入同一网络：

   docker run --name cloud-client --network spring-cloud-net -p 8787:8787 客户端镜像名
   

2. 验证配置中心连通性 #

进入客户端容器，执行curl命令测试能否拉取配置：

docker exec -it 客户端容器ID curl http://config-server:9090/CloudClient/default

若返回配置内容则网络正常，否则检查防火墙或网络配置。

3. 检查启动参数是否覆盖配置 #

客户端Dockerfile的ENTRYPOINT中指定了--spring.config.name=spring-cloud-config-api，但bootstrap.yml中应用名为CloudClient，需确保Git仓库中存在对应名称的配置文件（如CloudClient.properties或spring-cloud-config-api.properties），否则会拉取错误的配置。

可去掉ENTRYPOINT中的--spring.config.name=spring-cloud-config-api参数，或同步Git仓库中的配置文件名。

4. 确认客户端依赖完整性 #

检查客户端pom.xml是否包含Spring Cloud Config客户端依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-config</artifactId>
</dependency>

缺少该依赖会导致客户端无法识别配置中心逻辑。

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