IntelliJ IDEA中如何抑制Mockito代码的‘Value is never used as Publisher’警告？

问题场景 #

使用Mockito编写测试代码时，比如这句：

doReturn(Mono.just(something)).when(monoSupplier).get();

IntelliJ IDEA会高亮get()方法，提示"Value is never used as Publisher"警告，希望通过@SuppressWarnings局部消除该警告，而非全局禁用。

排查与根因 #

最初尝试替换为when()方法也没能解决问题，一度怀疑是IDE Bug，最终确认核心原因是导入错误：误导入了Reactor的reactor.core.publisher.Mono.when静态方法，而非Mockito的org.mockito.Mockito.when。

解决方案 #

1. 修正导入（优先推荐）

检查代码的import语句，确保使用Mockito的when方法：

• 替换错误导入为：

  import static org.mockito.Mockito.when;
  

• 或者直接使用全限定类名调用，彻底避免导入冲突：

  doReturn(Mono.just(something)).when(org.mockito.Mockito.when(monoSupplier).get());
  

2. 局部Suppress警告（仅用于IDE误报场景）

如果确认导入无误仍出现警告，可通过@SuppressWarnings指定对应警告码：

• 先获取具体警告码：将鼠标悬停在警告上，点击「更多操作」→「抑制警告」，选择局部抑制方式（方法级/代码块级），IDE会自动生成对应的警告码（通常为ReactiveStreamsPublisherReturnValueIgnored）。
• 示例用法：

  @SuppressWarnings("ReactiveStreamsPublisherReturnValueIgnored")
  void testMonoSupplier() {
      doReturn(Mono.just(something)).when(monoSupplier).get();
  }
  

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