Groovy引入mockito-inline与Mockito报InvalidUseOfMatchersException
Groovy 环境下引入 mockito-inline 导致原有 Mock 用例报 InvalidUseOfMatchersException 的适配方案
触发机制拆解
- 报错与测试代码写法无关,属于 mockito-inline 替换全局默认 MockMaker 后,其字节码代理逻辑与 Groovy 动态方法分发机制的固有冲突
- 未引入 mockito-inline 时,默认加载的
SubclassByteBuddyMockMaker仅代理Java层可重写的实例方法,对Groovy运行时的CallSiteArray动态调用链路无任何拦截,原有测试写法可正常运行 - 引入 mockito-inline 后,内置的
InlineByteBuddyMockMaker会基于 JVM Instrumentation 能力修改所有待代理类的字节码,包括Groovy类自动生成的getMetaClass、invokeMethod等桥接静态方法。当调用普通Mock方法传入any()这类参数匹配器时,Groovy动态分发链路会误将匹配器的上下文注册过程计入正式的Mock方法调用流程,最终触发匹配器计数错配,抛出「预期0个匹配器,实际已记录1个」的错误 - 错误栈指向Groovy的
CallSiteArray、getMetaClass调用,本质就是上述动态桥接逻辑被Inline代理拦截的直接表现,并非测试代码真的违反了匹配器使用规范
版本兼容性判定
当前使用的版本组合存在明确的已知兼容缺陷:
- Groovy 2.5.x 全版本 与 Mockito 3.8.0 内置的 mockito-inline 实现存在原生冲突,即使将Groovy从2.5.8升级到2.5.14,也无法绕过该字节码层面的逻辑不兼容
- 该冲突不是依赖版本错配导致,是 Mockito 3.8.0 版本的 Inline MockMaker 未针对Groovy动态类的字节码结构做特殊适配
适配方案与正确依赖搭配
要同时支持静态类/静态方法Mock能力,且不破坏原有普通Mock用例的运行,需遵循以下配置规则:
- 优先将Mockito全家桶(
mockito-junit-jupiter、mockito-inline、关联传递依赖)升级至 4.4.0 及以上版本。该版本开始Inline MockMaker正式适配Groovy动态类的调用链路,不会再误拦截CallSite、getMetaClass等桥接方法的匹配器计数逻辑 - 严格保证
mockito-junit-jupiter与mockito-inline的版本号完全一致,禁止跨版本混合引入 - 新增测试资源下的 Mockito 扩展配置,固定MockMaker的加载逻辑,避免类路径扫描顺序导致的实现加载错配:
- 配置文件路径:
src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker - 文件内容直接写入:
mock-maker-inline
- 配置文件路径:
- 若业务场景无法升级Mockito版本,可保留原有3.8.0版本的
SubclassByteBuddyMockMaker作为默认实现,单独引入静态Mock的独立适配包,不全局替换MockMaker实现,即可避免对原有Groovy Mock用例的侵入性影响
常见误区澄清
- 原有测试代码无需做任何修改:所有符合Mockito规范的参数匹配器写法,在适配配置完成后可无改动正常运行
- Groovy版本升级不会加剧该问题:高版本Groovy对字节码代理的兼容性更好,不存在版本越高冲突越严重的情况
- 报错提示的「InvalidUseOfMatchersException」属于误导性提示:本质是Inline代理逻辑将Groovy动态桥接方法的调用算作正式Mock方法调用,导致匹配器计数与实际入参不匹配,并非测试代码真的出现了原生值与匹配器混用的问题
内容的提问来源于stack exchange,提问作者Montezuma
相关产品推荐
相关产品推荐

