使用Mockito编写单元测试时,如何基于传入参数Mock数据库返回的对象
Mockito单元测试实现指南
核心误区澄清
- Mockito打桩的对象是被测方法所依赖的外部组件,绝不是需要测试的目标方法本身。如果你直接给
findUserCreatedLastTwoDays方法写打桩逻辑,相当于完全跳过了方法内部的真实业务逻辑,根本无法验证方法的正确性。 - 测试覆盖的两个独立场景需要拆成两个独立的测试用例,不需要在同一个测试方法内写if条件判断来切换打桩返回值。单测的核心原则是“一个用例只覆盖一个确定场景”,加分支逻辑反而会降低测试的可读性和可维护性。
你之前写的带条件判断的打桩代码,本质上就是因为混淆了Mock的目标对象,才会产生需要根据条件设置返回值的需求。
测试前置结构梳理
首先明确分层逻辑:你要测试的findUserCreatedLastTwoDays是业务层方法,内部一定会调用持久层组件(如UserRepository/Mapper)执行实际的数据库查询,真实的代码结构大致如下:
@Service public class UserService { // 被测方法依赖的持久层组件,是测试中需要Mock的对象 private final UserRepository userRepository; public UserService(UserRepository userRepository) { this.userRepository = userRepository; } // 这是本次测试需要覆盖的目标方法 public User findUserCreatedLastTwoDays(String id, Date dateAccepted) { return userRepository.selectByIdAndDateAfter(id, dateAccepted); } }
具体实现步骤
- 测试类基础配置
- 开启Mockito扩展支持,自动识别测试中的Mock对象
- 用
@Mock标注需要模拟的持久层组件UserRepository - 用
@InjectMocks标注要测试的业务类UserService,让Mockito自动把Mock的依赖注入到业务类实例中
- 拆分两个独立的测试用例,分别覆盖两个目标场景:
- 场景1:用户ID匹配、创建时间晚于传入的dateAccepted,方法返回对应User对象
- 场景2:用户ID匹配、创建时间早于传入的dateAccepted,方法返回null
- 每个测试用例按照固定流程实现:构造测试数据→给Mock的依赖打桩设置预期返回值→调用被测方法→断言校验返回结果
完整测试代码示例
@ExtendWith(MockitoExtension.class) class UserServiceTest { // 模拟持久层依赖 @Mock private UserRepository userRepository; // 注入被测业务对象 @InjectMocks private UserService userService; @Test void whenUserDateCreatedAfterAccepted_thenReturnMatchedUser() { // 构造测试入参 String testId = "user_001"; Date dateAccepted = Date.from( LocalDate.now().minusDays(2) .atStartOfDay(ZoneId.systemDefault()) .toInstant() ); // 构造符合查询条件的预期用户 User expectedUser = new User(); expectedUser.setId(testId); expectedUser.setDateCreated(new Date(System.currentTimeMillis() - 24 * 60 * 60 * 1000)); // 给Mock的持久层方法打桩:传入匹配参数时返回预期用户 when(userRepository.selectByIdAndDateAfter(testId, dateAccepted)) .thenReturn(expectedUser); // 调用被测方法 User actualResult = userService.findUserCreatedLastTwoDays(testId, dateAccepted); // 断言校验返回结果 assertThat(actualResult).isEqualTo(expectedUser); // 校验是否按预期调用了持久层方法 verify(userRepository).selectByIdAndDateAfter(testId, dateAccepted); } @Test void whenUserDateCreatedBeforeAccepted_thenReturnNull() { // 构造测试入参 String testId = "user_001"; Date dateAccepted = Date.from( LocalDate.now().minusDays(2) .atStartOfDay(ZoneId.systemDefault()) .toInstant() ); // 给Mock的持久层方法打桩:无匹配查询结果时返回null when(userRepository.selectByIdAndDateAfter(testId, dateAccepted)) .thenReturn(null); // 调用被测方法 User actualResult = userService.findUserCreatedLastTwoDays(testId, dateAccepted); // 断言返回结果为null assertThat(actualResult).isNull(); verify(userRepository).selectByIdAndDateAfter(testId, dateAccepted); } }
注意事项
- 打桩时传入的参数要和测试用例中传给被测方法的参数完全匹配,否则Mockito无法匹配到对应的返回值
- 不需要在测试逻辑中手动判断用户的dateCreated和dateAccepted的大小关系来设置打桩值,两个测试用例本身就对应了两种时间场景
- 所有的测试数据构造都要在测试方法内部完成,不要复用跨用例的可变对象,避免测试之间互相干扰
内容的提问来源于stack exchange,提问作者user1417127
相关产品推荐
相关产品推荐

