Spring WebClient onStatus无法适配HttpStatus::is4xxClientError问题排查

这是Spring 6（对应Spring Boot 3）的API使用问题，和VS Code IDE无关。

原因说明 #

Spring Boot 3.x依赖的Spring Framework 6.x对WebClient的API做了类型调整：

• WebClient.ResponseSpec.onStatus(...)的第一个参数要求是Predicate<HttpStatusCode>类型，用于匹配响应状态码。
• 你使用的HttpStatus::is4xxClientError是枚举类HttpStatus的实例方法，但onStatus接收的参数是HttpStatusCode接口类型的实例——并非所有HttpStatusCode都是HttpStatus枚举对象，因此会触发「方法参数不适用」的类型匹配错误。

正确写法 #

改用HttpStatusCode接口的默认方法引用，就能完全匹配参数要求：

webClient.get()
         .uri("/target-api")
         .retrieve()
         .onStatus(HttpStatusCode::is4xxClientError, response -> 
             // 自定义4xx错误处理逻辑，比如返回Mono.error()
             Mono.error(new RuntimeException("客户端请求错误"))
         );

额外说明 #

你之前尝试的Builder模式、全限定名、重启IDE、清理M2仓库等操作无效，是因为问题本质不是依赖缓存或IDE故障，而是代码中方法引用的类型不匹配，属于API使用错误。

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