@WebMvcTest测试遇401/404异常：排查解决及注解差异疑问

注：问题已解决，分享出来希望帮到更多人，部分代码为西班牙语。

个人感受 #

Spring测试体系确实有点混乱：JUnit版本不统一、同一个问题能用好几种注解解决、有些解法虽然能跑通但概念上并不准确，真心期待有深度的讲解视频。

问题场景 #

使用@WebMvcTest(ClienteController.class)测试ClienteController时，遇到两个问题：

• 无法正确加载自定义安全配置
• 找不到正常运行时可用的端点

排查与解决过程 #

1. 最初，控制器依赖CircuitBreakerRegistry类型的Bean，该Bean定义在自定义的CircuitBreakerConfiguration类中，于是使用@ContextConfiguration注解引入这个配置类。此时前两个测试通过，但正确认证的测试仍返回401——原因是自定义的SecurityConfig未被加载。
2. 随后添加@ActiveProfiles("test")及对应的application-test.yml，并将SecurityConfig也加入@ContextConfiguration中。401问题解决了，但又出现404错误。排查后发现：@ContextConfiguration会覆盖@WebMvcTest指定的控制器类，导致ClienteController未被加载。
3. 给测试类添加@Import(ClienteController.class)后，所有测试全部通过。最终改用@Import注解引入所有需要的配置类。

核心疑问解析 #

@ContextConfiguration与@Import看似都能解决配置引入的问题，二者的区别远不止“覆盖/添加”这一点：

• 作用逻辑不同：
  • @ContextConfiguration是Spring测试专用注解，用于指定测试上下文的配置源（类、XML文件等），它会完全替换掉@WebMvcTest、@SpringBootTest这类注解的默认上下文配置逻辑。
  • @Import是Spring核心注解，用于在配置类中导入其他配置类/Bean定义，在测试中使用时，是往现有测试上下文里追加内容，不会破坏原有注解的默认行为。
• 适用场景差异：
  • 当你需要完全自定义测试上下文，不想依赖@WebMvcTest等注解的自动配置时，优先使用@ContextConfiguration。比如要搭建一个极简的测试环境，只加载指定的几个类，完全脱离自动配置体系。
  • 如果你只是在@WebMvcTest等已有默认上下文的基础上，补充少量配置或Bean，就用@Import，它能保证原有注解的默认配置依然生效，避免出现上下文覆盖导致的问题。

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