如何在Spring Boot中注入MockMvc？注入时遇Bean创建异常求助

嘿，我之前也踩过MockMvc注入的坑！结合自己的排查经验，给你几个实用的解决方向：

• 先检查测试类的注解是否正确
  这是最容易出错的地方！如果是只测试Web层的场景，确保测试类标注了@WebMvcTest(目标Controller.class)；如果需要加载完整应用上下文做集成测试，要搭配@SpringBootTest和@AutoConfigureMockMvc。举个例子：

  // 仅测试Web层的写法
  @WebMvcTest(UserController.class)
  public class UserControllerTest {
      @Autowired
      private MockMvc mockMvc;
      // ... 测试逻辑
  }
  
  // 完整上下文集成测试的写法
  @SpringBootTest
  @AutoConfigureMockMvc
  public class FullAppIntegrationTest {
      @Autowired
      private MockMvc mockMvc;
      // ... 测试逻辑
  }
  

  另外注意：Spring Boot 2.2+版本可以不用额外加@ExtendWith(SpringExtension.class)，但老版本可能需要补上哦。

• 确认测试依赖是否齐全
  确保你的项目依赖里包含了spring-boot-starter-test，它已经打包了MockMvc需要的所有核心组件。Maven的依赖配置参考：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
  </dependency>
  

• 排查上下文加载的冲突问题
  别同时混用@WebMvcTest和@SpringBootTest，这两个注解的上下文加载范围不同，混用很容易导致Bean冲突。记住：

  • @WebMvcTest只加载Web相关Bean，适合快速单测Controller；
  • @SpringBootTest加载完整应用上下文，适合需要联动Service/Repository的集成测试，此时必须加@AutoConfigureMockMvc才能启用MockMvc。

• 深挖嵌套异常找根因
  你给出的错误提示里有nested exception，这才是问题的核心！建议把完整的异常栈打出来，大概率是你的Controller依赖的某个Bean没被正确处理——比如在@WebMvcTest场景下，Controller依赖的Service层Bean没有被Mock，导致上下文找不到它。这种情况用@MockBean就能解决：

  @WebMvcTest(UserController.class)
  public class UserControllerTest {
      @Autowired
      private MockMvc mockMvc;
      
      @MockBean
      private UserService userService; // Mock掉Controller依赖的Service
      // ... 测试逻辑
  }
  

内容的提问来源于stack exchange，提问作者Leandro Borges Ferreira