本文详解如何在 Mockito 测试中正确捕获 Class 类型的方法参数，解决 No argument value was captured! 错误，并提供可复用的 stubbing 与 verify 实践方案。

本文详解如何在 mockito 测试中正确捕获 `class` 类型的方法参数，解决 `no argument value was captured!` 错误，并提供可复用的 stubbing 与 verify 实践方案。

在使用 Mockito 对泛型方法（如 T response(RequestContent, Class)）进行单元测试时，开发者常因误用 ArgumentCaptor 而遇到 No argument value was captured! 异常。该错误并非语法问题，而是逻辑时序错误：ArgumentCaptor.capture() 必须在 verify() 中调用（而非 when() 或 doReturn()），且被测方法必须真实执行——否则捕获器无值可存。

✅ 正确用法：分三步完成 stub → invoke → verify

首先，为 response() 方法设置返回行为，无需捕获 Class 参数（除非需断言其具体类型）：

Account expectedAccount = new Account("test-user", 100.0);
doReturn(expectedAccount)
    .when(stub)
    .response(isA(RequestContent.class), any(Class.class)); // ✅ 推荐：宽松匹配
// 或严格匹配特定类型：
// .response(isA(RequestContent.class), eq(Account.class));   // ❗若传入其他 Class 将导致 stub 不命中

接着，触发被测代码（即调用 response(...) 的业务逻辑）：

// 假设 systemUnderTest 内部调用了 stub.response(...)
systemUnderTest.processRequest(); // ← 此处必须实际调用 stub.response()

最后，在 verify() 中使用 ArgumentCaptor 捕获 RequestContent（或 Class>，若需验证类型）：

// 捕获 RequestContent（更常见需求）
ArgumentCaptor<requestcontent> requestCaptor = ArgumentCaptor.forClass(RequestContent.class);
verify(stub).response(requestCaptor.capture(), any(Class.class));
assertThat(requestCaptor.getValue()).isNotNull();
assertThat(requestCaptor.getValue().getEndpoint()).isEqualTo("/accounts");

// 若需捕获并断言 Class 参数本身：
ArgumentCaptor<class>> classCaptor = ArgumentCaptor.forClass(Class.class);
verify(stub).response(isA(RequestContent.class), classCaptor.capture());
assertThat(classCaptor.getValue()).isEqualTo(Account.class);</class></requestcontent>

? 提示：推荐使用 @Captor 注解简化初始化：

@ExtendWith(MockitoExtension.class)
class MyTest {
    @Mock Stub stub;
    @Captor ArgumentCaptor<requestcontent> requestCaptor;
    // …
}</requestcontent>

⚠️ 关键注意事项

• capture() 只应在 verify() 中使用：在 when() 或 doReturn() 中调用 capture() 是无效且误导的，Mockito 不支持“stub 时捕获”。
• any(Class.class) vs eq(Account.class)：前者提高测试鲁棒性；后者增强契约校验——若业务逻辑意外传入 User.class，测试将立即失败，利于早期发现问题。
• RequestContent 需支持合理比较：若需精确校验请求内容，建议实现 equals()/hashCode()，或直接使用 eq(expectedRequest) 替代 capture()，使断言更简洁：

  RequestContent expected = RequestContent.builder().path("/accounts").build();
  verify(stub).response(eq(expected), any(Class.class));

通过遵循“先 stub、再 invoke、后 verify + capture”的标准流程，并明确区分参数匹配（any/eq）与参数捕获（capture()）的语义，即可稳定、清晰地验证泛型方法的行为，彻底规避捕获失败异常。