You need to enable JavaScript to run this app. 使用Mockito编写单元测试时,如何基于传入参数Mock数据库返回的对象
优惠活动
大模型
产品
解决方案
定价
更多

使用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);
    }
}

具体实现步骤

  1. 测试类基础配置
    • 开启Mockito扩展支持,自动识别测试中的Mock对象
    • 用@Mock标注需要模拟的持久层组件UserRepository
    • 用@InjectMocks标注要测试的业务类UserService,让Mockito自动把Mock的依赖注入到业务类实例中
  2. 拆分两个独立的测试用例,分别覆盖两个目标场景:
    • 场景1:用户ID匹配、创建时间晚于传入的dateAccepted,方法返回对应User对象
    • 场景2:用户ID匹配、创建时间早于传入的dateAccepted,方法返回null
  3. 每个测试用例按照固定流程实现:构造测试数据→给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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 19:15:04