@WebMvcTest中ControllerAdvice无法注入ErrorMessages的问题排查

这种情况我之前也踩过坑，多半是切片测试的上下文范围有限，或者Spring Cloud配置的自动配置没被正确加载导致的。给你几个实用的解决方案，按顺序试试：

1. 手动导入必要组件到测试上下文 #

默认情况下，@WebMvcTest只会聚焦于指定的控制器，不会自动扫描@ControllerAdvice和自定义配置类。你可以用@Import把GlobalExceptionHandler和ErrorMessages手动导入测试类：

@WebMvcTest(SomeController.class)
@Import({GlobalExceptionHandler.class, ErrorMessages.class})
public class SomeControllerTest {
    // 你的测试代码
}

如果GlobalExceptionHandler指定了basePackages，也要确保测试类的包路径在这个范围内，或者调整@WebMvcTest的basePackages属性来覆盖扫描范围。

2. 启用Spring Cloud配置相关的自动配置 #

@WebMvcTest默认不会加载Spring Cloud配置的自动配置类，所以用@Value读取的配置值可能无法被注入。你可以添加@EnableConfigurationProperties来开启配置属性的支持：

@WebMvcTest(SomeController.class)
@Import({GlobalExceptionHandler.class, ErrorMessages.class})
@EnableConfigurationProperties
public class SomeControllerTest {
    // 你的测试代码
}

如果你的ErrorMessages是用@ConfigurationProperties注解的（这是比@Value更推荐的方式），可以直接指定类来精准启用：

@EnableConfigurationProperties(ErrorMessages.class)

3. 模拟配置值（避免依赖真实配置中心） #

如果测试时不想依赖外部配置中心，可以直接在测试里注入模拟的配置值：

• 用@TestPropertySource直接指定属性：

@WebMvcTest(SomeController.class)
@Import({GlobalExceptionHandler.class, ErrorMessages.class})
@TestPropertySource(properties = {
    "error.messages.not-found=测试用：资源不存在",
    "error.messages.bad-request=测试用：请求无效"
})
public class SomeControllerTest {
    // 你的测试代码
}

• 或者在src/test/resources下创建application-test.yml，写入测试配置，然后用@ActiveProfiles("test")激活：

@WebMvcTest(SomeController.class)
@Import({GlobalExceptionHandler.class, ErrorMessages.class})
@ActiveProfiles("test")
public class SomeControllerTest {
    // 你的测试代码
}

4. 检查组件扫描和依赖配置 #

• 确认ErrorMessages类上有@Component或@Configuration注解，确保Spring能扫描到它；如果用@ConfigurationProperties，主类或配置类上要有@ConfigurationPropertiesScan注解，测试类也要能覆盖到这个扫描范围。
• 检查Gradle依赖，确保spring-boot-starter-test和spring-cloud-starter-config的版本匹配，没有依赖冲突。版本不一致经常会导致自动配置失效。

5. 调试上下文加载过程 #

如果以上方法都不行，开启Spring的调试日志，看看上下文加载时的细节：
在src/test/resources/application-test.properties里添加：

logging.level.org.springframework.context=DEBUG
logging.level.org.springframework.beans=DEBUG

这样能看到ErrorMessages是否被正确创建、@Value的属性有没有被赋值，以及GlobalExceptionHandler是否成功注入了它，帮你定位具体哪里出了问题。

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