本文详解如何在 Mockito 测试中正确捕获 Class 类型的方法参数，解决因误用 ArgumentCaptor 或错误 stubbing 导致的 “No argument value was captured!” 异常，并提供可直接复用的验证与存根（stub）代码模板。

本文详解如何在 mockito 测试中正确捕获 `class` 类型的方法参数，解决因误用 `argumentcaptor` 或错误 stubbing 导致的 “no argument value was captured!” 异常，并提供可直接复用的验证与存根（stub）代码模板。

在使用 Mockito 对泛型方法（如 T response(RequestContent, Class)）进行单元测试时，开发者常因混淆 stubbing（存根） 与 verification（验证） 阶段对 ArgumentCaptor 的使用场景，而触发 No argument value was captured! 错误。该错误并非语法问题，而是逻辑误用：ArgumentCaptor.capture() 只应在 verify() 中用于提取实际调用的参数值，绝不能用于 when() 或 doReturn() 的 stub 定义中。

✅ 正确做法：分三步完成测试

1. Stub 方法行为（不捕获，仅匹配）
   使用 any(Class.class) 或 eq(Account.class) 匹配 Class 参数，避免提前调用 capture()：

   Account expectedAccount = new Account("test-user", 100.0);
   doReturn(expectedAccount)
       .when(stub)
       .response(any(RequestContent.class), eq(Account.class)); // 精确匹配 Account.class
   // 或宽松匹配：any(Class.class)

2. 触发被测系统（SUT）执行
   确保实际调用 response(...) 方法——这是参数被捕获的前提：

   systemUnderTest.processRequest(); // 内部调用 stub.response(request, Account.class)

3. 验证调用并捕获参数
   在 verify() 中使用 ArgumentCaptor 提取真实传入的 RequestContent（或 Class>），此时 capture() 才生效：

   ArgumentCaptor<requestcontent> requestCaptor = ArgumentCaptor.forClass(RequestContent.class);
   verify(stub).response(requestCaptor.capture(), eq(Account.class));
   
   // 断言请求内容是否符合预期
   RequestContent actualRequest = requestCaptor.getValue();
   assertThat(actualRequest.getEndpoint()).isEqualTo("/accounts");
   assertThat(actualRequest.getHeaders()).containsKey("Authorization");</requestcontent>

⚠️ 注意事项：

• ❌ 错误示例：doReturn(...).when(...).response(captor.capture(), ...) —— capture() 在 stub 阶段无效，且会导致后续 verify 失败；
• ✅ 推荐写法：若需验证 Class 参数本身（如确认是否为 Account.class），直接用 eq(Account.class) 即可，无需 captor；
• ? 进阶技巧：若 RequestContent 实现了合理的 equals()/hashCode()，可用 eq(expectedRequest) 替代 capture()，使断言更简洁；
• ? 注解简化：配合 @Captor ArgumentCaptor requestCaptor; 和 @Before 初始化，可减少样板代码。

通过严格区分 stubbing 与 verification 的语义边界，并将 ArgumentCaptor 限定于 verify() 调用中，即可稳定捕获任意类型参数（包括 Class），精准验证方法调用行为与输入数据完整性。