如何区分 `@MockBean` 和 Mockito 中的 `@Mock`？两者适用范围有何不同？

### Spring `@MockBean` 与 Mockito `@Mock` 的区别及适用范围 #### 1. **定义与基本功能** - **`@MockBean`**: 这是一个由 Spring Boot 提供的注解，用于在测试环境中创建并注册一个 mock 对象到 Spring 应用上下文中。它可以完全替代某个 Bean 并影响整个容器中的依赖注入行为[^1]。 - **`@Mock`**: 此注解属于 Mockito 框架的一部分，主要用于局部范围内创建 mock 对象。它不会干扰 Spring 容器的状态，仅仅是在单个测试类或方法内部生效[^2]。 #### 2. **作用域差异** - **全局 vs 局部**: - `@MockBean` 影响的是整个 Spring 上下文。一旦使用该注解标记了一个 mock 对象，那么在整个测试过程中，任何地方只要需要这个类型的 Bean，都会得到这个 mock 实例[^1]。 - 相反，`@Mock` 只限于当前测试类或者特定的方法级别（如果配合 `@Before` 方法初始化的话）。它的生命周期较短，只服务于单一测试需求[^2]。 #### 3. **集成能力对比** - **Spring 容器感知**: - `@MockBean` 明确设计用来支持基于 Spring 的全面集成测试场景。例如，在控制器层测试时可以直接模拟服务层的行为；而在数据访问层则能轻松伪造 Repository 返回值[^1]。 - `@Mock` 更适合纯粹面向对象层次上的单元测试，尤其是那些不需要加载 Spring 容器就能完成的小规模验证任务。 #### 4. **具体例子说明** ##### (1) 使用 `@MockBean` 测试 Controller 下面展示如何利用 `@MockBean` 来隔离 Service 层逻辑，集中精力检验 HTTP 请求处理流程： ```java @SpringBootTest public class UserControllerTest { @Autowired private MockMvc mockMvc; @MockBean private UserService userService; // 替换掉真实的 UserService 实现 @Test public void testGetUser() throws Exception { User user = new User(); user.setId(1L); user.setName("John"); Mockito.when(userService.getUserById(1L)).thenReturn(Optional.of(user)); mockMvc.perform(MockMvcRequestBuilders.get("/users/1")) .andExpect(status().isOk()) .andExpect(jsonPath("$.name", is("John"))); } } ``` 此处可以看出，`@MockBean` 不仅简化了对复杂外部系统的依赖管理，还使得测试更加聚焦和高效。 --- ##### (2) 利用 `@Mock` 执行简单业务逻辑测试 假如我们有一个简单的 Java 类负责计算折扣金额，可以采用如下方式对其进行独立测试： ```java import static org.mockito.Mockito.*; import static org.junit.Assert.*; public class DiscountCalculatorTest { @Mock private PricingStrategy pricingStrategy; // 创建本地 mock 对象 @InjectMocks private DiscountCalculator calculator = new DiscountCalculator(); @Test public void calculateDiscount_shouldReturnCorrectValue() { when(pricingStrategy.getPrice(anyString())).thenReturn(BigDecimal.valueOf(100)); BigDecimal result = calculator.calculateDiscount("itemA"); verify(pricingStrategy, times(1)).getPrice(eq("itemA")); assertEquals(BigDecimal.valueOf(90), result); // 假设固定打九折 } } ``` 在这个例子中，由于未涉及到 Spring 容器相关内容，因此选用 `@Mock` 即可满足需求。 --- ### 总结 虽然两者都提供了 mock 功能来辅助软件质量保障活动，但它们各自针对不同的测试层面进行了优化： - 当面临复杂的、依托于 Spring IoC/DI 结构的大规模集成测试时，推荐优先考虑 `@MockBean`； - 若只是单纯为了验证某段孤立算法正确与否，则可以选择更为轻便快捷的 `@Mock` 方案[^2]。