Mock WebClient时RequestHeadersUriSpec类型报错解决

参考代码能正常运行的核心原因 #

• 你参考的spring-data-elasticsearch测试代码、eugenp的Spring响应式教程示例，大多编写于较早的Java、Spring版本周期，这类项目本身的编译配置普遍没有开启严格的泛型 unchecked 校验，原始类型的警告会被编译器自动忽略
• 部分示例代码为了简化演示逻辑，会刻意省略泛型参数，本身就属于不规范的原始类型写法，只是能跑通Mock流程，并没有严格遵循Java类型安全的编码规范
• 不少老项目的全局编译配置会自带-Xlint:none参数关闭所有编译警告，哪怕是原始类型引用、不兼容的泛型转换，都不会触发提示，自然看起来“正常运行不报错”

泛型报错的底层原因 #

WebClient的get()方法返回值的实际类型，是固定泛型参数的WebClient.RequestHeadersUriSpec<WebClient.RequestHeadersSpec<?>>。当你手动声明RequestHeadersUriSpec<?>类型的变量时，Java编译器会为每个独立的通配符引用生成专属的捕获类型（也就是报错信息里提到的capture#1-of ?、capture#3-of ?），不同的捕获类型之间不具备兼容性，直接传入thenReturn方法就会触发类型不匹配的编译错误。

无警告、可正常编译的解决方案 #

• 方案一：匹配方法返回的实际泛型类型声明Mock对象
  直接按照webClient.get()的返回泛型定义变量，从根源上消除类型不兼容问题，无任何编译警告：

  @Test
  public void mytest() {
    WebClient webClient = mock(WebClient.class);
    WebClient.RequestHeadersUriSpec<WebClient.RequestHeadersSpec<?>> headersUriSpec = mock(WebClient.RequestHeadersUriSpec.class);
    when(webClient.get()).thenReturn(headersUriSpec);
  }
  

• 方案二：让Mockito自动推断泛型类型，避免手动声明变量的类型偏差
  把Mock对象的创建直接嵌入thenReturn方法的参数位置，让编译器自动匹配桩方法需要的泛型参数，不需要手动写冗长的泛型定义：

  @Test
  public void mytest() {
    WebClient webClient = mock(WebClient.class);
    when(webClient.get()).thenReturn(mock(WebClient.RequestHeadersUriSpec.class));
  }
  

• 方案三：对必须使用通配符的场景做精准警告压制
  如果业务代码里确实需要用RequestHeadersUriSpec<?>作为变量类型，只需要在对应变量的声明行加单条的警告注解，不会影响整个测试类的其他类型校验规则：

  @Test
  public void mytest() {
    WebClient webClient = mock(WebClient.class);
    @SuppressWarnings("unchecked")
    WebClient.RequestHeadersUriSpec<?> headersUriSpec = mock(WebClient.RequestHeadersUriSpec.class);
    when(webClient.get()).thenReturn(headersUriSpec);
  }
  

  注意不要在类级别添加全局的警告压制注解，否则会掩盖测试代码中其他真实存在的类型安全问题

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