使用Mockito模拟RestClient失效，请求排查原因

问题原因 #

• 参数匹配不精准：原代码中headers和onStatus方法传入的是lambda/方法引用，测试中使用泛型的any()，结合RETURNS_DEEP_STUBS的深mock机制，Mockito无法正确识别参数类型，导致调用链匹配失败。
• 深stub的不确定性：RETURNS_DEEP_STUBS虽然简化了链式mock，但对复杂参数的处理不够稳定，容易出现匹配偏差，返回默认的null值。

解决方案 #

方案1：手动mock每个链式调用的中间对象（推荐） #

避免依赖深stub，逐个mock RestClient调用链中的每个阶段对象，参数匹配更可控：

@Mock
RestClient restClient;
@Mock
RestClient.PostHeadersSpec postHeadersSpec;
@Mock
RestClient.RequestBodySpec requestBodySpec;
@Mock
RestClient.ResponseSpec responseSpec;
@Mock
RestClient.ResponseSpec afterOnStatusSpec;

@Test
public void someTestMethod() {
    // 按调用顺序mock每个阶段的返回对象
    when(restClient.post()).thenReturn(postHeadersSpec);
    // 匹配headers方法的Consumer类型参数
    when(postHeadersSpec.headers(any(Consumer.class))).thenReturn(postHeadersSpec);
    // 精准匹配contentType的MediaType
    when(postHeadersSpec.contentType(eq(MediaType.APPLICATION_FORM_URLENCODED))).thenReturn(requestBodySpec);
    when(requestBodySpec.body(any(Object.class))).thenReturn(requestBodySpec);
    when(requestBodySpec.retrieve()).thenReturn(responseSpec);
    // 匹配onStatus的Predicate和Consumer类型参数
    when(responseSpec.onStatus(any(Predicate.class), any(Consumer.class))).thenReturn(afterOnStatusSpec);
    // 最终返回指定字符串
    when(afterOnStatusSpec.body(String.class)).thenReturn("Some String");

    // 执行被测试的业务方法...
}

方案2：优化深stub的参数匹配 #

如果坚持使用RETURNS_DEEP_STUBS，需要精准匹配参数类型和具体值，提高匹配成功率：

@Mock(answer = Answers.RETURNS_DEEP_STUBS)
RestClient restClient;

@Test
public void someTestMethod() {
    when(restClient.post()
            .headers(any(Consumer.class)) // 指定参数类型为Consumer
            .contentType(eq(MediaType.APPLICATION_FORM_URLENCODED)) // 精准匹配MediaType
            .body(any())
            .retrieve()
            .onStatus(any(Predicate.class), any(Consumer.class)) // 指定参数类型
            .body(String.class))
    .thenReturn("Some String");

    // 执行被测试的业务方法...
}

关键说明 #

• 链式mock的核心是严格匹配调用顺序和参数类型，lambda/方法引用属于函数式接口实例，需用any(Consumer.class)、any(Predicate.class)这类具体类型匹配，而非泛型any()。
• 手动mock中间对象的方式更透明，便于调试和维护，避免深stub带来的隐性问题。

内容的提问来源于stack exchange，提问作者Nit