Eureka通过ConfigServer读取Git仓库配置不生效问题求助

问题场景 #

搭建微服务示例项目时，先部署Spring Cloud Config Server配置中心，再启动Eureka注册中心服务，预期Eureka从配置中心拉取Git仓库存储的远程配置，实际未生效：Git侧配置Eureka服务端口为8761，Eureka启动后始终占用默认8080端口。

Config Server 本地application.yaml配置 #

server:
  port: 8081
spring:
  cloud:
    config:
      server:
        git:
          default-label: main
          uri: https://github.com/mguzm4n/microservices-data
          search-paths: config-data
  application:
    name: config-server

配置说明：配置中心绑定Git存储后端，默认拉取main分支内容，配置文件搜索路径为仓库下的config-data目录。

Eureka Server 本地bootstrap.yaml配置 #

spring:
  application:
    name: eureka-server
  cloud:
    config:
      enabled: true
      uri: http://localhost:8081

操作顺序：先启动8081端口的Config Server，再启动Eureka服务。 #

按优先级排查步骤 #

• 优先检查依赖缺失问题
  Spring Cloud 2020.0.0及以上版本默认禁用了Bootstrap上下文加载逻辑，如果Eureka服务没有引入spring-cloud-starter-bootstrap依赖，resources目录下的bootstrap.yaml根本不会被解析，服务启动时不会主动请求Config Server拉取远程配置，直接走本地默认参数启动，这是该问题最高发的原因。
  引入对应Maven依赖即可修复：

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

  同时要确认Eureka服务引入了spring-cloud-starter-config依赖，缺失该依赖会导致Config Client客户端功能完全不生效。
• 验证Config Server服务可用性
  直接请求Config Server的配置拉取接口，确认配置中心本身能正常读取Git仓库内容：本地发起GET请求到地址http://localhost:8081/eureka-server/default，查看响应内容中是否包含server.port: 8761的配置项。
  • 如果接口返回404、空响应，或没有对应端口配置：排查Config Server侧问题，检查服务所在网络是否能正常访问目标Git仓库，确认仓库main分支下config-data目录确实存在eureka-server.yaml文件，查看Config Server启动日志是否存在Git拉取失败报错（如权限不足、分支不存在、路径拼写错误）。
  • 如果接口正常返回对应端口配置：说明Config Server侧逻辑正常，问题出在Eureka服务的配置加载环节。
• 检查Eureka服务配置加载逻辑
  启动Eureka服务时查看控制台日志，搜索PropertySourceBootstrapConfiguration相关日志行：
  • 如果没有出现Located property source: CompositePropertySource {name='configService'}类日志，说明服务根本没有触发远程配置拉取流程，需要确认bootstrap.yaml文件是否放在Eureka服务的resources根目录下，打包后是否存在于生成的jar包的classes目录中，避免路径放置错误导致配置文件未被识别。
• 核对远程配置文件命名规则
  Spring Cloud Config拉取远程配置时，严格按照<spring.application.name>-<active-profile>.yaml、<spring.application.name>.yaml的规则匹配文件名，需要确认Git仓库中配置文件的文件名和Eureka配置的spring.application.name值完全一致，避免拼写偏差（如多字符、少字符、下划线代替横杠等问题）。

高版本Spring Cloud如果不想引入bootstrap依赖，也可以把Config Client的相关配置移到application.yaml中，通过spring.config.import=configserver:http://localhost:8081的方式指定拉取配置中心的配置，效果和bootstrap配置一致。

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