如何用本地配置覆盖Spring Cloud指定属性（集成测试场景）

问题背景 #

云端配置中心的配置如下：

something:
  that: not be overriding
cache:
  size: 1000
  duration: 3

对应的Java配置类：

@Configuration
@EnableCaching
@ConfigurationProperties(prefix = "cache")
public class CachingConfig extends CachingConfigurerSupport {

    private int duration;
    private int maxSize;
    
    // 省略getter/setter
}

需求：在集成测试中，通过test/resources/application-test.yml仅覆盖cache.duration和cache.maxSize对应的配置值，保留云端的something相关配置不变。

实现步骤 #

完全可以实现，核心利用Spring Boot叠加式配置覆盖的特性，只需要以下两步：

1. 编写测试环境配置文件

在test/resources下创建application-test.yml，只写入需要覆盖的属性（不需要写全量配置）：

cache:
  duration: 10  # 覆盖云端的3
  max-size: 2000  # 对应配置类的maxSize字段，Spring Boot自动映射驼峰到短横线命名

注意：如果你的配置类字段和云端配置的key直接对应（比如配置类用size而非maxSize），则写cache.size: 2000即可。

2. 激活测试环境并编写集成测试

在测试类上添加@ActiveProfiles("test")，让Spring Boot加载上述测试配置：

@SpringBootTest
@ActiveProfiles("test")
public class CachingConfigIntegrationTest {

    @Autowired
    private CachingConfig cachingConfig;

    @Test
    void verifyConfigOverrides() {
        // 验证覆盖后的属性值
        assert cachingConfig.getDuration() == 10;
        assert cachingConfig.getMaxSize() == 2000;
        
        // 若需要验证云端的something配置未被修改，可注入对应配置类后验证
        // 比如：@Autowired private SomethingConfig somethingConfig;
        // assert somethingConfig.getThat().equals("not be overriding");
    }
}

原理说明 #

Spring Boot的配置加载遵循优先级叠加规则：

• 本地测试环境的application-test.yml优先级高于云端配置中心的配置
• 仅会覆盖你显式指定的属性，未在测试配置中提及的属性（如something.that）会完全保留云端配置的原值

注意事项 #

• 必须确保测试类上的@ActiveProfiles("test")正确配置，否则不会加载测试环境的配置文件
• 配置类字段与yml中的key要匹配：默认驼峰命名的字段（如maxSize）对应yml中的短横线命名（max-size），若要直接用驼峰key，可在配置中添加spring.configuration-properties.bind-camel-case-to-hyphen=false
• 如果使用Spring Cloud Config/Nacos等配置中心，需确保测试环境下配置中心的配置正常加载，测试配置会自动覆盖同名属性

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