You need to enable JavaScript to run this app. 用Mockito为返回国家列表的getCountries方法编写JUnit单元测试
优惠活动
大模型
产品
解决方案
定价
更多

用Mockito为返回国家列表的getCountries方法编写JUnit单元测试

问题根源

你之前的mock逻辑和实际调用对不上,本质是混淆了NamedParameterJdbcTemplate两个完全不同的API:

  • 待测试方法里实际调用的是 query 重载方法,接收SQL、参数源、行映射器三个入参,返回值是查询结果组成的List
  • 你之前写的mock针对的是 queryForObject 方法,这个方法是用来查询单条单值结果的,方法签名、返回类型都和实际调用不匹配,Mockito自然没法命中打桩逻辑。
正确的单元测试实现

前置准备

  • 在测试类中用@Mock声明模拟的NamedParameterJdbcTemplate对象,通过依赖注入装配到待测试的业务类实例中
  • 提前准备好测试用例的入参(比如测试传入国家编码"CN")、预期返回结果(比如构造好的国家名称列表Arrays.asList("中国"))

打桩逻辑(核心修正)

因为业务方法是在调用时才动态生成MapSqlParameterSource参数对象,你测试类里提前new的参数对象和方法实际传入的对象引用不一致,硬编码匹配会失败,正确的打桩写法如下:

Mockito.when(
    namedParameterJdbcTemplate.query(
        Mockito.anyString(), // 匹配任意SQL,也可以用Mockito.eq(实际SQL值)严格校验
        Mockito.any(SqlParameterSource.class), // 匹配业务方法内部生成的参数源
        Mockito.any(RowMapper.class) // 匹配方法内传入的行映射器逻辑
    )
).thenReturn(预期的国家名称列表);

增强校验(可选)

如果需要校验业务方法拼的SQL、传的参数值没有出错,可以用参数捕获器拿到实际传给JdbcTemplate的对象做断言,避免打桩太宽松漏掉代码问题:

// 捕获实际传入的参数源对象
ArgumentCaptor<SqlParameterSource> paramCaptor = ArgumentCaptor.forClass(SqlParameterSource.class);
// 确认query方法被调用时,SQL和实际业务写的完全一致
Mockito.verify(namedParameterJdbcTemplate).query(
    Mockito.eq("select COUNTRY_NAME from MY_COUNTRY WHERE COUNTRY_CD = :countryCd "),
    paramCaptor.capture(),
    Mockito.any(RowMapper.class)
);
// 校验传入的countryCd参数值和测试入参匹配
assertEquals("CN", ((MapSqlParameterSource) paramCaptor.getValue()).getValue("countryCd"));

测试断言

  • 调用待测试的getCountries("CN")方法拿到实际返回结果
  • 断言实际返回的列表和提前准备的预期结果完全一致
  • 确认整个流程没有抛出异常
常见踩坑提醒
  • 不要混用query和queryForObject的mock逻辑:两个方法的参数列表、返回值类型都不同,用错方法签名会直接导致打桩失效
  • 不要在打桩阶段硬编码自己new的参数对象做匹配:Mockito默认对自定义对象用引用匹配,就算两个对象存的值一样,引用不同也匹配不上,优先用参数匹配器放宽打桩,后续通过捕获器做参数校验
  • 不要跳过对参数的校验:只返回mock结果不校验参数的话,就算业务方法把参数拼错了测试也会通过,起不到单测的防护作用

内容的提问来源于stack exchange,提问作者neo27

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.02 04:45:03