运行Mockito官方示例触发InvalidUseOfMatchersException问题求助

问题背景 #

运行Mockito官方文档中「11. Stubbing with callbacks」章节的示例时，触发InvalidUseOfMatchersException异常，提示信息为：

You cannot use argument matchers outside of verification or stubbing

无法定位违规点，怀疑是否因@InjectMocks注解导致问题，需明确自身代码与官方示例的差异，以及修复方案。

涉及代码与信息 #

• 业务类：TestMockWeb
• 测试类：TestMockWebTest（使用@InjectMocks注解）
• 完整异常堆栈信息

问题原因分析 #

InvalidUseOfMatchersException的核心触发原因是：参数匹配器（如any()、eq()、argThat()等）被用于Mockito存根（when/then）或验证（verify）逻辑之外的场景。

@InjectMocks本身不会直接引发该异常，但如果在测试类初始化、依赖注入过程中，或业务逻辑调用时误用了参数匹配器，就会触发报错。

排查与修复建议 #

1. 检查参数匹配器的使用范围 #

确保所有参数匹配器仅出现在以下场景中：

• 存根逻辑：when(mock.targetMethod(匹配器)).thenXXX()
• 验证逻辑：verify(mock).targetMethod(匹配器)

绝对禁止在普通方法调用、字段赋值、构造方法初始化等非Mockito存根/验证逻辑中使用匹配器，例如以下错误写法：

// 错误：在普通变量赋值中使用匹配器
String wrongParam = anyString();
// 错误：在业务对象初始化时使用匹配器
TestMockWeb web = new TestMockWeb(any(SomeDependency.class));

2. 对齐官方回调存根示例 #

官方回调存根的标准写法类似：

when(mock.someMethod(anyString())).thenAnswer(invocation -> {
    Object[] args = invocation.getArguments();
    return "处理参数：" + Arrays.toString(args);
});

对比自身代码：

• 确认when()方法内的参数是否正确使用匹配器，未将匹配器泄露到回调逻辑之外
• 检查thenAnswer的回调代码中，是否误用了参数匹配器（回调内仅需通过invocation.getArguments()获取参数，无需再用匹配器）

3. 排查@InjectMocks相关逻辑 #

• 检查测试类中@InjectMocks注入的TestMockWeb实例，其依赖是否为正确的Mock对象，而非误用匹配器创建的实例
• 检查@Before等初始化方法中，是否存在误用匹配器的代码

4. 利用异常堆栈精准定位 #

异常堆栈会明确标记触发报错的代码行，找到该行后，确认是否存在非存根/验证场景下的匹配器使用，直接修正即可。

内容的提问来源于stack exchange，提问作者wmz