本文详解如何在 Mockito 测试中正确捕获 Class<T> 类型的方法参数，解决因误用 ArgumentCaptor 或错误 stubbing 导致的 “No argument value was captured!” 异常，并提供可直接复用的验证与存根（stub）代码模板。
本文详解如何在 mockito 测试中正确捕获 `class
在使用 Mockito 对泛型方法（如 <T> T response(RequestContent, Class<T>)）进行单元测试时，开发者常因混淆 stubbing（存根） 与 verification（验证） 阶段对 ArgumentCaptor 的使用场景，而触发 No argument value was captured! 错误。该错误并非语法问题，而是逻辑误用：ArgumentCaptor.capture() 只应在 verify() 中用于提取实际调用的参数值，绝不能用于 when() 或 doReturn() 的 stub 定义中。
✅ 正确做法：分三步完成测试
-
Stub 方法行为（不捕获，仅匹配）
使用 any(Class.class) 或 eq(Account.class) 匹配 Class<T> 参数，避免提前调用 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) -
触发被测系统（SUT）执行
确保实际调用 response(...) 方法——这是参数被捕获的前提：systemUnderTest.processRequest(); // 内部调用 stub.response(request, Account.class)
-
验证调用并捕获参数
在 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");
⚠️ 注意事项：
- ❌ 错误示例：doReturn(...).when(...).response(captor.capture(), ...) —— capture() 在 stub 阶段无效，且会导致后续 verify 失败；
- ✅ 推荐写法：若需验证 Class<T> 参数本身（如确认是否为 Account.class），直接用 eq(Account.class) 即可，无需 captor；
- ? 进阶技巧：若 RequestContent 实现了合理的 equals()/hashCode()，可用 eq(expectedRequest) 替代 capture()，使断言更简洁；
- ? 注解简化：配合 @Captor ArgumentCaptor<RequestContent> requestCaptor; 和 @Before 初始化，可减少样板代码。
通过严格区分 stubbing 与 verification 的语义边界，并将 ArgumentCaptor 限定于 verify() 调用中，即可稳定捕获任意类型参数（包括 Class<T>），精准验证方法调用行为与输入数据完整性。
