Mockito中带类型参数的泛型方法如何正确使用any参数匹配器
泛型方法mock时的参数匹配器报错问题
问题复现
- 编写测试代码时,尝试为带显式类型参数的
getItems方法使用any参数匹配器:
when(store.getItems[Product](any[FilterParams])) .thenReturn(allProducts)
- 执行测试时抛出框架错误:
Invalid use of argument matchers! 2 matchers expected, 1 recorded
- 初步排查后的对照测试结果:将参数匹配器替换为实际的
FilterParams对象实例后,测试可正常运行:
when(store.getItems[Product](FilterParams())) .thenReturn(allProducts)
- 对报错原因的初步推测:该异常是由调用
getItems方法时显式传入Product类型参数导致的。
待澄清的疑问
- 是否存在可用于类型参数维度的参数匹配器?
- 调用带泛型类型参数的函数完成mock配置时,是否必须显式传递类型参数?
上下文补充
- 说明:此处测试中提及的
Product并非Scala语言内置的Product特质 - 被测
getItems方法的实际函数签名:
def getItems[T <: ItemType : universe.TypeTag](filterParams: FilterParams): List[T]
问题本质与解决方式
- 报错的根本原因和显式传入类型参数完全无关:Scala中的上下文界语法
[T <: ItemType : universe.TypeTag]会在编译期自动为方法追加一个独立的隐式参数列表,等价于生成的真实方法签名是:
这个方法总共包含2个可匹配的入参(1个显式的def getItems[T <: ItemType](filterParams: FilterParams)(implicit evidence$1: universe.TypeTag[T]): List[T]filterParams、1个编译器自动生成的隐式TypeTag参数)。 - Mockito的参数匹配器有固定的计数规则:
- 只要一次方法调用中触发了任意一个匹配器方法(比如
any()),框架就会要求本次方法调用的**所有入参(含隐式入参)**都必须通过匹配器传入,不能混合实际值与匹配器。 - 之前的错误写法只给显式参数传入了1个匹配器,没有给隐式的
TypeTag参数传入对应匹配器,因此才会出现“2个匹配器预期、1个已记录”的报错。 - 当你直接传入实际的
FilterParams()实例、完全不使用任何匹配器时,框架会跳过匹配器计数逻辑,直接按equals规则匹配所有入参,因此不会触发校验错误。
- 只要一次方法调用中触发了任意一个匹配器方法(比如
- 对核心疑问的明确解答:
- 不存在可用于类型参数维度的参数匹配器:因为JVM层面存在泛型擦除机制,类型参数不会参与方法的实际入参构成,Mockito这类基于JVM的框架根本无法感知调用时传入的泛型类型参数,自然也不可能提供对应的类型匹配能力。
- 调用带泛型类型参数的方法时,完全不需要强制显式传递类型参数:只要遵守Mockito的匹配器规则,由编译器自动推断泛型类型即可正常完成mock配置。
- 正确的可运行写法示例:
// 显式传入两个匹配器,分别对应显式filter参数、隐式TypeTag参数 when( store.getItems[Product](any[FilterParams])(any[universe.TypeTag[Product]]) ).thenReturn(allProducts)
内容的提问来源于stack exchange,提问作者ssmallya
相关产品推荐
相关产品推荐

