Mockito模拟依赖对象行为：单元测试中的关键技术与最佳实践
目录导读
为什么需要模拟依赖对象
在真实的企业级项目中,一个类通常依赖多个外部组件：数据库、第三方API、消息队列、文件系统等，假设你正在编写一个用户注册服务，它需要调用EmailService发送邮件、调用UserRepository保存数据、调用LogService记录日志，如果依赖这些真实组件进行测试，会带来三大问题：
- 环境依赖：需要启动数据库、连接网络服务
- 状态不确定性：真实服务可能返回不同结果
- 测试速度慢：一次测试可能耗时数秒甚至数分钟
模拟对象（Mock Object） 的核心价值在于：通过创建虚假对象，模拟真实对象的行为，从而将测试焦点完全集中在被测试代码本身，Mockito是Java生态中最流行的模拟框架，它让我们能以简洁的语法控制依赖对象的行为。
Mockito核心概念速览
在深入模拟技巧前,先掌握三个基础概念：
| 概念 | 说明 | 常用方法 |
|---|---|---|
| Mock对象 | 完全模拟的对象，所有方法默认返回默认值（如null、0、false） | mock(Class) |
| Stub（打桩） | 定义mock对象的某个方法在特定参数下应返回什么值 | when().thenReturn() |
| 验证（Verify） | 检查mock对象的某个方法是否按预期被调用 | verify(mock).method() |
权威引用：根据Mockito官方文档（mockito.org），模拟对象的主要特性是“默认情况下，所有方法返回默认值，且不会执行真实逻辑”。
模拟依赖对象的五种核心场景
基本返回值模拟
// 模拟UserService依赖的UserRepository
UserRepository mockRepo = mock(UserRepository.class);
when(mockRepo.findById(123L)).thenReturn(new User("张三"));
UserService service = new UserService(mockRepo);
User result = service.getUserById(123L);
assertEquals("张三", result.getName());
模拟异常抛出
when(mockRepo.save(any(User.class)))
.thenThrow(new DataAccessException("数据库连接失败"));
assertThrows(DataAccessException.class, () -> service.createUser(new User()));
关键点：使用any()匹配器可以匹配任意参数，但要注意参数类型匹配。
模拟void方法
// EmailService.sendEmail()返回void
doNothing().when(mockEmailService).sendEmail(anyString(), anyString());
// 或者模拟抛出异常
doThrow(new RuntimeException("邮件服务超时"))
.when(mockEmailService).sendEmail(anyString(), anyString());
模拟链式调用
// 模拟ResultSet的常见链式调用
ResultSet mockRs = mock(ResultSet.class);
when(mockRs.next()).thenReturn(true);
when(mockRs.getString("name")).thenReturn("李四");
// 当测试代码调用rs.next() && rs.getString("name")时，会正常工作
模拟复杂依赖注入（Spring环境）
@ExtendWith(MockitoExtension.class)
class OrderServiceTest {
@Mock
private PaymentGateway paymentGateway;
@InjectMocks
private OrderService orderService;
@Test
void testPaymentSuccess() {
when(paymentGateway.charge(anyDouble()))
.thenReturn(new PaymentResult(true, "TX123"));
Order order = orderService.placeOrder(new Order(100.0));
assertTrue(order.isSuccess());
verify(paymentGateway).charge(100.0);
}
}
常见陷阱与避坑指南
陷阱1：过度模拟导致测试失效
错误示例：模拟了被测试类的方法
@Mock private OrderService orderService; // ❌ 不应该模拟被测试类
陷阱2：参数不匹配导致stub失效
// 假设方法签名是 findById(Long id)，但传入int when(mockRepo.findById(1)).thenReturn(user); // 1是int，不会匹配 // 正确写法：使用精确类型或匹配器 when(mockRepo.findById(1L)).thenReturn(user);
陷阱3：忽略Verify的调用次数
service.updateUser(user); verify(mockRepo).save(user); // 默认验证1次 verify(mockRepo, times(1)).save(user); // 明确指定 verify(mockRepo, never()).delete(any()); // 验证从未调用
陷阱4：依赖真实实现导致模拟失败
// 如果UserRepository是final类，Mockito 2.x需要额外配置 // 解决方法：使用PowerMock或Mockito的inline mock maker
问答环节：Mockito模拟依赖的高频问题
Q1：什么时候应该使用@Mock而不是手动创建mock？
A：当测试类有多个依赖时，@Mock配合@InjectMocks可以自动注入模拟对象，减少样板代码，手动创建mock(Class)适合单一依赖或需要定制配置的场景。
Q2：模拟对象和间谍（Spy）有什么区别？ A：模拟对象完全替代真实行为，间谍对象则会调用真实方法，但可以手动覆写部分方法。
List<String> spyList = spy(new ArrayList<>());
when(spyList.size()).thenReturn(100);
spyList.add("one"); // 真实add方法会被调用
assertEquals("one", spyList.get(0)); // 真实get方法也被调用
assertEquals(100, spyList.size()); // stub后的size返回100
Q3：如何模拟静态方法或构造方法？
A：Mockito 3.4+支持通过mockStatic()模拟静态方法，但官方更推荐重构代码，将静态调用包装为依赖注入的对象，若必须模拟，可考虑PowerMock扩展。
Q4：模拟方法调用时，验证顺序重要吗？
A：如果业务逻辑依赖调用顺序，可以使用InOrder：
InOrder inOrder = inOrder(mockRepo, mockEmailService); inOrder.verify(mockRepo).save(user); inOrder.verify(mockEmailService).sendEmail(user.getEmail(), "注册成功");
Q5：如何解决“Unnecessary Stubbing”警告？
A：如果stub的方法在测试中从未被调用，Mockito会输出警告，解决方案：删除未使用的stub，或使用lenient()模式：
lenient().when(mockRepo.findByEmail(any())).thenReturn(null);
从模拟到高效测试
Mockito模拟依赖对象行为的核心价值在于隔离测试，通过本文的五个场景和四个陷阱，你应该能够：
- 精准控制：使用
when().thenReturn()和doThrow()模拟任何依赖行为 - 验证交互：通过
verify()确认依赖对象的方法被正确调用 - 避免反模式：不模拟被测试类、注意参数类型匹配、合理使用spy
在真实的项目实践中,建议遵循“只在边界类上使用模拟”原则——模拟的对象应该是进入和离开被测试系统的接口，而不是内部的工具类，这样既能保持测试的灵活性，又不会让模拟代码过度膨胀。
记住Mockito官方核心哲学：模拟的是行为，而不是数据，当你需要模拟一个复杂的对象状态时，不妨先思考是否可以通过重构设计，让测试变得更简单。
