本文直击 Spring Boot 集成测试中 @MockBean 失效的核心原因：控制器内手动 new 实例导致依赖未由 Spring 容器管理，使 Mock 完全被绕过；并提供从诊断到修复的一站式实践指南。
本文直击 spring boot 集成测试中 `@mockbean` 失效的核心原因：控制器内手动 new 实例导致依赖未由 spring 容器管理，使 mock 完全被绕过；并提供从诊断到修复的一站式实践指南。
在 Spring Boot 测试中，@MockBean 是隔离外部依赖、实现可控集成验证的关键工具。但许多开发者会遇到“明明写了 doReturn("Hi").when(testService).greet()，接口返回的却是 "Hello"”这类看似诡异的问题——根本原因并非 Mockito 失效，而是 Spring 的依赖注入机制从未生效。
问题代码中的关键缺陷在于控制器中对服务的初始化方式：
// ❌ 错误：手动 new 实例，脱离 Spring 容器管理 public TestService testService = new TestServiceImpl();
该写法使 testService 成为一个普通 Java 对象（POJO），而非 Spring 管理的 Bean。因此：
- @MockBean private TestServiceImpl testService; 注入的 mock 实例仅存在于测试类上下文中；
- 控制器调用的 testService.greet() 实际执行的是 new TestServiceImpl() 的原始方法；
- Mock 行为完全被绕过，@MockBean 形同虚设。
✅ 正确做法是将服务声明为 Spring Bean，并通过依赖注入获取：
@RestController
public class ExampleController {
// ✅ 正确：由 Spring 自动注入（字段注入或构造器注入）
private final TestService testService;
public ExampleController(TestService testService) { // 推荐：构造器注入
this.testService = testService;
}
@GetMapping("/test")
public String test() {
return testService.greet(); // 此处调用的是容器中的 Bean —— 可被 @MockBean 替换
}
}
对应测试类保持简洁清晰：
@WebMvcTest(ExampleController.class) // ✅ 仅加载目标 Controller 及其依赖
class ExampleApplicationTests {
@Autowired
private MockMvc mockMvc;
@MockBean
private TestService testService; // 注意：类型应为接口，非具体实现类（更符合依赖倒置）
@Test
void testGreetEndpoint_returnsMockedValue() throws Exception {
// Given: stub 接口方法（非实现类）
when(testService.greet()).thenReturn("Hi");
// When & Then
mockMvc.perform(get("/test")
.contentType(MediaType.APPLICATION_JSON))
.andExpect(status().isOk())
.andExpect(content().string("Hi"));
}
}
? 关键要点总结：
- @WebMvcTest 默认仅扫描 @Controller 及其直接依赖，不会加载全量 @SpringBootTest 上下文，性能更高、隔离性更强；
- @MockBean 必须作用于Spring 容器中实际注入的 Bean 类型（推荐使用接口类型，如 TestService 而非 TestServiceImpl）；
- 控制器中禁止 new XxxService()，所有协作对象必须通过 @Autowired 或构造器注入；
- 若服务类为 final 或含 final 方法，需启用 Mockito inline mock（mockito-inline 依赖）或改用 @SpyBean + thenCallRealMethod() 组合。
⚠️ 补充提醒：若测试仍失败，请检查是否遗漏 @Service 注解（TestServiceImpl 必须被 Spring 扫描为 Bean）、包路径是否在组件扫描范围内，以及 @WebMvcTest 是否错误指定了主应用类（如 ExampleApplication.class）而非控制器类——这会导致上下文加载不完整，Mock 无法注册。
遵循以上规范，@MockBean 将严格按预期工作：每个测试方法运行时，Spring 自动注入已配置 stub 的 mock 实例，确保 API 层测试真正验证控制器逻辑，而非意外穿透到真实服务实现。
