JUnit测试运行抛出Mockito InvalidUseOfMatchersException异常问题
异常根因定位
该异常的核心触发逻辑来自Mockito的参数匹配器设计规则,结合代码与堆栈可定位到具体问题:
- 异常提示“1 matchers expected, 3 recorded”,对应代码中3处违规调用Mockito匹配器的位置:
salesOrderItem.setOrderItemIdentifier(Mockito.any(Long.class))salesOrderItem.setProductUnitPrice(Mockito.any(String.class))salesOrder.setOrderIdentifier(Mockito.anyLong())
- Mockito的参数匹配器(如
any()、eq())仅允许在两类场景中使用:- 为mock对象打桩时的方法入参(即
when(mock.method(入参))结构) - 校验mock对象调用时的方法入参(即
verify(mock).method(入参)结构)
- 为mock对象打桩时的方法入参(即
- 上述代码中,匹配器被误用为普通实体类setter方法的赋值参数。所有调用匹配器的操作都会往Mockito内部的全局匹配器栈中写入一个占位符,由于这些占位符没有对应的打桩/验证逻辑消费,会一直残留在栈中。
- 当代码执行到打桩语句
when(salesDao.getSalesOrderItems(1l))时,Mockito校验栈内的匹配器数量:当前打桩的方法只接收1个入参,且传的是原始值1L,本应记录0个匹配器,但栈中已经残留了3个未被消费的占位符,参数数量校验不通过,因此抛出InvalidUseOfMatchersException,堆栈指向当前打桩行号。
修复方案
- 移除所有在普通实体构造、赋值流程中误用的
Mockito.any()调用,替换为明确的测试用固定值:// 错误写法(误用匹配器给实体赋值) salesOrderItem.setOrderItemIdentifier(Mockito.any(Long.class)); salesOrderItem.setProductUnitPrice(Mockito.any(String.class)); salesOrder.setOrderIdentifier(Mockito.anyLong()); // 正确写法(使用明确的测试值) salesOrderItem.setOrderItemIdentifier(1L); salesOrderItem.setProductUnitPrice("99.99"); salesOrder.setOrderIdentifier(1L); - 打桩逻辑保持匹配器使用规范:如果使用原始值传参,就不要混用匹配器;如果需要匹配任意入参,所有入参都要用匹配器包裹,不要出现原始值和匹配器混用的情况,例如:
// 正确:传原始值打桩(注意Long字面量建议写大写1L,避免小写l和数字1混淆) when(salesDao.getSalesOrderItems(1L)).thenReturn(getSalesOrderList()); // 正确:全匹配器打桩 when(salesDao.getSalesOrderItems(anyLong())).thenReturn(getSalesOrderList());
内容的提问来源于stack exchange,提问作者bharathi
相关产品推荐
相关产品推荐

