用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
相关产品推荐
相关产品推荐

