使用Mockito测试Mono和Flux时遇参数匹配问题求解决

这个问题我之前也碰到过，核心原因是Mockito对响应式类型的匹配逻辑和普通对象不一样，我来给你拆解一下并提供几种解决方案：

为什么用具体Mono实例匹配失败？ #

Mockito默认使用对象的equals()方法来匹配参数，但Mono作为Reactor的响应式类型，它的equals()实现是基于对象引用的，完全不关心内部包含的ItemParams内容。

你测试代码里创建的params（Mono.just(new ItemParams("1"))）和控制器方法中接收到的itemParms（WebClient请求解析后生成的全新Mono实例）是两个完全不同的对象，所以Mockito根本匹配不到这个mock调用，自然不会返回你预设的result，最终导致响应体为空。

解决方案 #

1. 匹配任意Mono实例（简单直接） #

如果不需要校验传入service.getItems()的参数内容，直接用ArgumentMatchers.any(Mono.class)就能解决问题，这也是你已经验证过可行的方式：

import org.mockito.ArgumentMatchers;

// ...

Mockito.when(this.service.getItems(ArgumentMatchers.any(Mono.class))).thenReturn(result);

这种方式适合只关注端点返回结果是否符合预期，不需要严格校验请求参数的场景。

2. 验证Mono中的参数内容（更严谨） #

如果需要确保传入的Mono里的ItemParams是正确的，可以用ArgumentMatchers.argThat()结合Reactor的StepVerifier来检查Mono内部的元素：

import org.mockito.ArgumentMatchers;
import reactor.test.StepVerifier;

// ...

Mockito.when(this.service.getItems(ArgumentMatchers.argThat(mono -> {
    // 验证Mono中的ItemParams是否符合预期
    StepVerifier.create(mono)
        .expectNextMatches(params -> "1".equals(params.getId())) // 假设ItemParams有getId()方法
        .verifyComplete();
    return true;
}))).thenReturn(result);

这种方式既保证了mock能匹配到调用，又验证了传入的参数内容准确，适合需要严格校验请求参数的场景。

避坑提醒：重写ItemParams的equals没用 #

别想着给ItemParams重写equals()和hashCode()就能解决问题——Mono的equals()只看对象引用，完全不关心内部元素是否相等，所以这种方法根本无效。

优化你的测试断言 #

另外，你测试里用result.collectList().block()来获取预期列表虽然能工作，但推荐用Reactor的测试风格避免阻塞：

.expectBodyList(Item.class)
.consumeWith(response -> {
    List<Item> expected = Arrays.asList(new Item("1"), new Item("2"));
    assertEquals(expected, response.getResponseBody());
});

或者更简洁的写法：

.expectBodyList(Item.class)
.hasSize(2)
.contains(new Item("1"), new Item("2"));

这样更符合响应式编程的测试习惯，也避免了block()带来的潜在问题。

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