Spring Boot MockMVC控制器测试遇NoSuchBeanDefinitionException求助

嘿，我来帮你搞定这个头疼的问题！你遇到的NoSuchBeanDefinitionException其实是@WebMvcTest注解的特性导致的，咱们一步步拆解原因和解决方案：

问题根源 #

@WebMvcTest是Spring Boot提供的轻量级Web层测试注解，它只会加载和Web层相关的Bean，比如控制器（@Controller）、控制器增强器（@ControllerAdvice）、JSON组件这些，默认不会加载Service、Repository层的Bean。

虽然你用@MockBean模拟了UserVehicleService，但Spring在管理这个Mock Bean的时候，会尝试去注入它依赖的MyRepository（因为你的UserVehicleService实现类里用了@Autowired装配MyRepository）。但此时测试上下文里根本没有MyRepository的Bean，所以就抛出了找不到Bean的异常。

解决方案 #

根据你的测试需求，有两种常用的解决思路：

1. 模拟Repository依赖（推荐用于纯Web层测试） #

既然你只是测试控制器的逻辑，不需要Service的真实业务代码，那直接把MyRepository也用@MockBean模拟掉就行。这样Spring容器里就有了这个Mock Bean，Service的依赖就能被满足了。

修改后的测试代码如下：

@RunWith(SpringRunner.class)
@WebMvcTest(UserVehicleController.class)
public class UserVehicleControllerTests {

    @Autowired
    private MockMvc mvc;

    @MockBean
    private UserVehicleService userVehicleService;
    
    @MockBean  // 新增：模拟Service依赖的Repository
    private MyRepository myRepository;

    @Test
    public void testExample() throws Exception {
        given(this.userVehicleService.getVehicleDetails("sboot"))
                .willReturn(new VehicleDetails("Honda", "Civic"));

        this.mvc.perform(get("/sboot/vehicle").accept(MediaType.TEXT_PLAIN))
                .andExpect(status().isOk())
                .andExpect(content().string("Honda Civic"));
    }
}

2. 加载完整Spring上下文（适合需要真实Service/Repository逻辑的场景） #

如果你需要测试控制器+Service的完整逻辑，甚至需要访问数据库，那可以改用@SpringBootTest配合@AutoConfigureMockMvc，这样会加载整个Spring应用上下文，包括Repository层的Bean。

注意：这种方式测试启动速度会慢一些，但适合集成测试场景。代码示例：

@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureMockMvc
public class UserVehicleControllerTests {

    @Autowired
    private MockMvc mvc;

    @Autowired  // 可以直接注入真实的Service
    private UserVehicleService userVehicleService;

    @Test
    public void testExample() throws Exception {
        // 如果需要指定返回值，也可以用@MockBean来覆盖Service的方法
        given(this.userVehicleService.getVehicleDetails("sboot"))
                .willReturn(new VehicleDetails("Honda", "Civic"));

        this.mvc.perform(get("/sboot/vehicle").accept(MediaType.TEXT_PLAIN))
                .andExpect(status().isOk())
                .andExpect(content().string("Honda Civic"));
    }
}

额外提示 #

尽量不要用@WebMvcTest的basePackages属性去强制扫描Service/Repository包，这违背了@WebMvcTest轻量级测试的设计初衷，会让测试变得臃肿且缓慢。

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