Spring Boot WebClient调用block()报错：不支持阻塞操作求助

这个异常的核心原因是在Reactor的IO线程（如reactor-http-epoll-2）中执行了阻塞操作block()。Reactor的IO线程属于事件循环线程，设计目的是处理非阻塞IO操作，绝对不允许执行阻塞调用——这会卡住整个事件循环，直接影响服务性能和可用性。

方案一：遵循响应式编程范式（推荐） #

如果你的调用链路本身是响应式的，直接返回Mono<ScoringResponse>，去掉block()，让调用方以响应式方式处理结果：

public Mono<ScoringResponse> search(SearchRequest searchRequest) {
    return webClient.post()
            .bodyValue(searchRequest)
            .retrieve()
            .onStatus(HttpStatusCode::isError, ERROR_HANDLER::handleError)
            .bodyToMono(ScoringResponse.class)
            .timeout(Duration.ofMillis(5_000))
            .subscribeOn(Schedulers.boundedElastic());
}

这种方式完全符合Reactive编程的设计原则，全程非阻塞，从根源上避免了异常。

方案二：强制同步调用（仅当无法改造响应式时使用） #

如果业务场景必须拿到同步返回结果，要确保block()在专门的阻塞线程池中执行，而非Reactor的IO线程。可以通过publishOn()将后续操作切换到boundedElastic线程池：

public ScoringResponse search(SearchRequest searchRequest) {
    return webClient.post()
            .bodyValue(searchRequest)
            .retrieve()
            .onStatus(HttpStatusCode::isError, ERROR_HANDLER::handleError)
            .bodyToMono(ScoringResponse.class)
            .timeout(Duration.ofMillis(5_000))
            .publishOn(Schedulers.boundedElastic()) // 把block()的执行切换到阻塞线程池
            .block();
}

另外，也可以确保调用这个search()方法的代码本身运行在非Reactor IO线程（比如Spring MVC的Servlet线程、自定义业务线程池）中，这样block()也不会触发异常。

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