Spring Boot 2.4.0中@TestConfiguration Bean覆盖在GitLab流水线失效问题

本地运行带@SpringBootTest的集成测试时，通过@TestConfiguration+@Primary覆盖的Bean能正常生效，但在GitLab流水线中Bean替换未生效，测试仍尝试用真实的UAMI连接AKV密钥保管库。已做的配置包括：

• 开启Bean覆盖：@SpringBootTest({"spring.main.allow-bean-definition-overriding=true"})
• 静态嵌套测试配置类：

@TestConfiguration
public static class DifferentClassNameThanTheConfigClass {

  @Bean
  @Primary
  public ClientToBeMocked differentMethodNameThanInConfligClass() {
    return new ClientToBeMocked(mockitoMock);
  }
}

• 在测试类上导入该配置：@Import(TestClassName.DifferentClassNameThanTheConfigClass.class)

• 环境配置差异
  检查GitLab运行环境中是否有额外配置覆盖了spring.main.allow-bean-definition-overriding=true：比如application-test.properties里的属性、流水线环境变量。可以在测试中打印该属性值确认是否生效：

  @Value("${spring.main.allow-bean-definition-overriding}")
  private boolean allowOverriding;
  
  @BeforeEach
  void checkOverridingConfig() {
      System.out.println("allow-bean-definition-overriding: " + allowOverriding);
  }
  

  同时确认GitLab环境是否启用了非测试的Spring Profile（比如prod），导致真实配置类被优先加载。

• Bean加载顺序问题
  真实配置类可能比测试配置类先完成注册，若allow-bean-definition-overriding未正确生效，即使加了@Primary也无法覆盖。可以给测试配置类设置最高优先级强制先加载：

  @TestConfiguration
  @Order(Ordered.HIGHEST_PRECEDENCE)
  public static class DifferentClassNameThanTheConfigClass {
      // ...
  }
  

• GitLab缓存导致上下文污染
  流水线可能启用了Spring上下文缓存，旧的真实Bean上下文未被清理复用。可以在测试类上加@DirtiesContext强制刷新：

  @SpringBootTest(...)
  @DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS)
  public class TestClassName {
      // ...
  }
  

  同时检查CI配置是否缓存了target目录或Spring缓存文件，导致旧编译产物/上下文被重复使用。

• Bean名称匹配问题
  Spring默认用方法名作为Bean名称，若真实Bean和测试Bean名称不一致，@Primary可能无法正确覆盖依赖特定名称的Bean。可以显式指定相同的Bean名称：

  // 真实配置类
  @Bean("clientToBeMocked")
  public ClientToBeMocked realClient() { ... }
  
  // 测试配置类
  @Bean("clientToBeMocked")
  @Primary
  public ClientToBeMocked differentMethodNameThanInConfligClass() { ... }
  

• 包扫描范围限制
  检查测试类位置是否在Spring Boot默认扫描范围内，或是否有@ComponentScan限制了扫描范围，导致测试配置类未被识别。可以尝试将测试配置类移到真实配置类同包下，或显式指定扫描范围。

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