Mockito模拟WebClient的onStatus调用时出现Strict Stubbing参数不匹配问题

我来帮你拆解下这个问题哈！你遇到的这个PotentialStubbingProblem报错，核心原因是Mockito的严格存根模式对参数匹配要求非常严格，而你存根时用的lambda表达式和实际代码调用时传入的lambda不是同一个实例，另外HttpStatus::isError这个方法引用的匹配也需要注意细节。

为什么会出现这个错误？ #

Mockito的Strict Stubbing（默认开启）会校验你存根时的参数和实际调用的参数是否完全一致。你存根里写的那个自定义lambda，和实际业务代码里传给onStatus的lambda是两个不同的对象，Mockito就会判定参数不匹配，抛出这个错误。另外，如果实际代码里调用onStatus的第一个参数不是HttpStatus::isError，也会导致匹配失败。

具体解决办法 #

这里给你几个实用的解决方案，按需选择：

方案一：用参数匹配器宽松匹配参数

如果不需要严格校验lambda的具体逻辑，可以用Mockito的参数匹配器来匹配方法引用和lambda：

import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.when;

// 存根时使用匹配器
when(responseSpec.onStatus(
    eq(HttpStatus::isError), // 精准匹配HttpStatus::isError方法引用
    any(Function.class)      // 匹配任意Function类型的lambda参数
)).thenReturn(responseSpec);

这个方案比较灵活，适合不需要验证lambda具体行为的场景。

方案二：把lambda提取为共享变量（推荐）

把你存根里的lambda逻辑提取成一个全局变量或者工具方法，让存根和实际代码调用onStatus时都用同一个lambda实例，这样参数就能完全匹配了：

// 把lambda提取为静态常量，测试和业务代码都可以复用
private static final Function<ClientResponse, Mono<? extends Throwable>> STATUS_ERROR_HANDLER = clientResponse -> {
    if (clientResponse.statusCode() == HttpStatus.resolve(402)) {
        return Mono.error(new Exception("402"));
    }
    if (clientResponse.statusCode() == HttpStatus.resolve(500)) {
        return Mono.error(new Exception("500"));
    }
    if (clientResponse.statusCode() == HttpStatus.resolve(512)) {
        return Mono.error(new Exception("512"));
    }
    return Mono.error(new Exception("Error while processing request"));
};

// 测试存根时用这个常量
when(responseSpec.onStatus(HttpStatus::isError, STATUS_ERROR_HANDLER))
    .thenReturn(responseSpec);

// 业务代码里调用onStatus时也用同一个常量
webClient.get()
    .uri("/your-api")
    .retrieve()
    .onStatus(HttpStatus::isError, STATUS_ERROR_HANDLER)
    ...

这种方式既解决了参数匹配问题，还能让错误处理逻辑复用，一举两得。

方案三：临时关闭严格存根模式（不推荐）

如果只是想快速绕过这个问题，可以在测试类上添加注解关闭严格模式，或者在存根时用lenient()标记：

// 方式1：在测试类上添加注解
@MockitoSettings(strictness = Strictness.LENIENT)
public class YourTestClass { ... }

// 方式2：针对单个存根宽松处理
lenient().when(responseSpec.onStatus(
    HttpStatus::isError,
    (clientResponse) -> {
        // 你的lambda逻辑
    }
)).thenReturn(responseSpec);

不过不建议长期这么做，因为严格存根模式能帮你发现测试中的潜在问题（比如多余的存根、参数不匹配的调用），关闭它可能会掩盖其他问题。

额外注意点 #

• 确保你测试中mock的responseSpec对象和实际代码中使用的是同一个实例，别搞混了mock对象。
• 如果是用WebClient Builder创建的实例，要确认ClientResponse、ResponseSpec这些相关组件都正确mock了。

备注：内容来源于stack exchange，提问作者Nesan Mano