本文详解如何在 Mockito 测试中正确捕获泛型方法中的 Class<T> 参数，包括 doReturn 的 stubbing 配置、ArgumentCaptor 的验证使用，以及避免“No argument value was captured!”错误的关键实践。

本文详解如何在 mockito 测试中正确捕获泛型方法中的 `class` 参数，包括 `doreturn` 的 stubbing 配置、`argumentcaptor` 的验证使用，以及避免“no argument value was captured!”错误的关键实践。

在使用 Mockito 对形如 <T> T response(RequestContent, Class<T>) 的泛型方法进行单元测试时，开发者常因误用 ArgumentCaptor 而遭遇 No argument value was captured! 错误。该错误并非源于语法错误，而是逻辑顺序问题：ArgumentCaptor 必须在被测方法实际调用后，通过 verify() 才能捕获参数；若在 stubbing（如 doReturn）阶段就尝试捕获，或未真正触发被测方法，则 captor 始终为空。

✅ 正确做法：分三步完成验证

1. Stub 方法行为（不在此处捕获）
   使用 any(Class.class) 或精确匹配 eq(Account.class) 指定类型参数：

   Account expectedAccount = new Account("test-user", 100);
   doReturn(expectedAccount)
       .when(stub)
       .response(isA(RequestContent.class), any(Class.class)); // ✅ 允许任意 Class 类型
   // 或更严格地：eq(Account.class)

2. 执行被测逻辑（关键！）
   确保系统真正调用了 response(...) 方法：

   systemUnderTest.processRequest(); // 此调用内部会触发 stub.response(...)

3. 验证并捕获参数（唯一合法使用 captor 的位置）
   使用 ArgumentCaptor.forClass() 捕获 RequestContent，同时对 Class 参数仍用 any() 或 eq() 匹配：

   ArgumentCaptor<RequestContent> requestCaptor = ArgumentCaptor.forClass(RequestContent.class);
   verify(stub).response(requestCaptor.capture(), any(Class.class));
   
   // 断言请求内容是否符合预期
   RequestContent captured = requestCaptor.getValue();
   assertThat(captured.getEndpoint()).isEqualTo("/accounts");
   assertThat(captured.getMethod()).isEqualTo("GET");

⚠️ 注意事项与最佳实践

• 不要在 doReturn(...).when().method(...) 中使用 capture()：ArgumentCaptor.capture() 仅适用于 verify()，在 stubbing 中使用会导致空捕获。

• 优先使用 eq(Class) 提升测试健壮性：若业务逻辑严格依赖 Account.class，用 eq(Account.class) 替代 any(Class.class)，可使测试在传入错误类型（如 User.class）时立即失败，而非静默通过。

• RequestContent 需支持合理比较：若其已正确定义 equals()/hashCode()，可在 stub 阶段直接用 eq(expectedRequest) 精确匹配，避免后续手动校验字段。

• 推荐使用 @Captor 注解简化代码：

  @Captor private ArgumentCaptor<RequestContent> requestCaptor;
  
  @Test
  void testResponseWithAccountType() {
      doReturn(new Account()).when(stub).response(any(), eq(Account.class));
      systemUnderTest.fetchAccount();
      verify(stub).response(requestCaptor.capture(), eq(Account.class));
      assertThat(requestCaptor.getValue()).hasValidAuthHeader();
  }

掌握这一模式后，不仅能解决 Class<T> 捕获问题，更能建立起“stub → execute → verify + capture”的标准 Mockito 测试范式，显著提升测试可维护性与可靠性。