在Mockito单元测试中，若在when()或verify()中混用参数匹配器（如any()）与具体值（如字符串字面量），会触发“Misplaced or misused argument matcher detected”异常；正确做法是统一使用匹配器，例如将实际参数替换为eq(value)。
在mockito单元测试中，若在`when()`或`verify()`中混用参数匹配器（如`any()`）与具体值（如字符串字面量），会触发“misplaced or misused argument matcher detected”异常；正确做法是统一使用匹配器，例如将实际参数替换为`eq(value)`。
该错误的根本原因在于 Mockito 的参数匹配器一致性规则：一旦方法调用中任一参数使用了匹配器（如 any(), eq(), isNull() 等），所有其他参数也必须使用匹配器。否则 Mockito 无法安全地解析参数边界，从而抛出 InvalidUseOfMatchersException。
在你的测试代码中：
when(paymentTicketService.generatePaymentTicket(
any(GeneratePaymentTicketRequest.class),
spokesmanDocumentNumber // ❌ 普通字符串字面量 —— 违反规则
)).thenReturn(paymentTicketPdfResponse);虽然 spokesmanDocumentNumber 是一个合法变量，但它不是匹配器，因此与 any(...) 混用即被判定为非法。
✅ 正确写法是将所有参数统一为匹配器形式：
when(paymentTicketService.generatePaymentTicket(
any(GeneratePaymentTicketRequest.class),
eq(spokesmanDocumentNumber) // ✅ 使用 eq() 匹配器包装实际值
)).thenReturn(paymentTicketPdfResponse);?
eq(T value)是最常用且语义清晰的匹配器，它等价于Objects.equals(actual, value)，适用于绝大多数场景。其他常用匹配器包括：
isNull()/notNull()contains("str")（用于字符串）argThat(ArgumentMatcher<t>)</t>（自定义逻辑）same(instance)（引用相等）
⚠️ 注意事项：
- 匹配器不能出现在
thenReturn()、thenThrow()或真实方法调用中（仅限 stubbing/verification 的参数位置）； - 若需部分参数精确匹配、部分模糊匹配，仍须全部使用匹配器（例如：
eq("fixed")+anyString()）； - 使用
@Mock或@Spy注入的依赖，其方法调用才受 Mockito 匹配器机制管控；@InjectMocks本身不启用代理，但所注入的 mock 对象行为仍遵循此规则。
? 总结：Mockito 要求“全匹配器”或“全具体值”，不可混用。养成习惯——只要用了 any()，就检查其余参数是否都已包裹在 eq() 或其他匹配器中。这不仅是避免报错的关键，更是编写可维护、可读性强的测试代码的重要规范。
