如何在 Spring WebClient 中设置和处理超时？

Question

Spring 文档说需要手动为 WebClient 配置 http 客户端以设置超时：https://docs.spring.io/spring/docs/current/spring-framework-reference/web-reactive.html#webflux-client-builder-reactor-timeout。 但是由于 WebClient 返回响应式 Mono，因此可以（api-wise）应用 .timeout 方法。

效果一样吗？

此外，当使用.timeout 方法时，预计Reactor 的TimeoutException。如果手动完成配置，流中是否会出现相同的错误，即doOnError(TimeoutException.class, ...) 是否有效？

Answer 1

我的发现

以特定于 http 客户端的方式设置超时将导致特定于 http 客户端的异常，即WebClient 不会包装异常：

@Test
void test() {
    var host = "localhost";
    var endpoint = "/test";
    var port = 8089;
    var timeout = Duration.ofSeconds(3);

    WireMockServer wireMockServer = new WireMockServer(wireMockConfig().port(8089));
    wireMockServer.start();
    WireMock.configureFor(host, wireMockServer.port());

    WireMock.stubFor(get(urlEqualTo(endpoint))
        .willReturn(aResponse().withFixedDelay((int) timeout.toMillis())));

    HttpClient httpClient = HttpClient.create()
        .tcpConfiguration(client ->
            client.doOnConnected(conn -> conn
                .addHandlerLast(new ReadTimeoutHandler((int) (timeout.toSeconds() / 2)))
                .addHandlerLast(new WriteTimeoutHandler((int) (timeout.toSeconds() / 2)))));

    WebClient webClient = WebClient.builder()
        .baseUrl(format("http://%s:%d", host, port))
        .clientConnector(new ReactorClientHttpConnector(httpClient)).build();

    webClient.get().uri(endpoint).retrieve().bodyToMono(Recommendation.class).block();
}

这将导致io.netty.handler.timeout.ReadTimeoutException。

.timeout(timeout.dividedBy(2)).block() 会导致常规的TimeoutException (java.util.concurrent)，但网络客户端是否会在之后处理连接仍然是一个悬而未决的问题（可能不会）。

我的解决方案是使用 http 客户端特定配置来确保使用连接的本机和正确方式，同时添加新的处理程序，将与 http 客户端相关的异常包装到更通用的异常（或 java.util.concurrent.TimeoutException）中，以便 WebClient 客户端不会取决于提供者例外。