Spring Boot配置客户端无法获取Config Server配置求助

配置文件与代码回顾 #

应用配置文件 #

spring:
  main:
    banner-mode: off
    allow-bean-definition-overriding: true
  config:
    uri: http://localhost:8890

配置类代码 #

@RefreshScope
@Configuration
@Getter
public class Service {

  @Value("${Some Value}")
  Boolean val;
}

可能的问题及解决方法 #

• 核心配置路径错误：原配置中spring.config.uri是错误的，Spring Cloud Config Client的正确配置键应为spring.cloud.config.uri，少了cloud层级会导致应用无法识别Config Server地址，修正后的配置：

  spring:
    main:
      banner-mode: off
      allow-bean-definition-overriding: true
    cloud:
      config:
        uri: http://localhost:8890
  

• 配置属性名格式非法：@Value("${Some Value}")中的属性名包含空格，Spring配置属性不允许空格，需改为驼峰式（someValue）或短横线分隔（some-value），同时确保Config Server中的配置键名与之一致。
• 缺少Config Client依赖：Spring Boot项目必须引入Spring Cloud Config Client依赖才能对接Config Server，示例依赖如下：
  Maven：

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

  Gradle：

  implementation 'org.springframework.cloud:spring-cloud-starter-config'
  

• 应用名称不匹配：Config Server是按应用名称（spring.application.name）匹配配置文件的，需确保应用的spring.application.name与Config Server上存储的配置文件名一致（比如应用名为demo，则Config Server需有demo.yml或demo.properties）。
• 启动日志排查：查看应用启动日志中ConfigServicePropertySourceLocator相关输出，检查是否有连接失败、权限错误或配置未找到的提示，定位具体问题。
• 暂去刷新注解测试：先移除@RefreshScope，测试基础配置加载是否正常，确认能获取配置后再添加刷新功能。

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