Spring Boot WebClient（WebFlux）block()请求是否有默认超时配置？

首先明确：你用Thread.sleep(2分钟)的方式完全没必要，还会浪费线程资源。WebClient本身提供了完善的超时配置项，针对你的场景，核心是调整读取超时（而非连接超时）——连接超时是建立TCP连接的等待时间（你认为默认30秒合理，保持即可），而读取超时是连接建立后等待服务返回响应的最大时长，这才是适配长耗时API的关键配置。

配置方式分两种场景： #

1. 全局配置（所有WebClient调用都使用长超时）

通过WebClient.Builder配置底层的Reactor HttpClient，统一设置超时规则：

@Bean
public WebClient webClient() {
    HttpClient httpClient = HttpClient.create()
            // 保持默认连接超时30秒
            .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 30000)
            // 设置读取超时为2分钟
            .responseTimeout(Duration.ofMinutes(2));

    return WebClient.builder()
            .clientConnector(new ReactorClientHttpConnector(httpClient))
            .build();
}

2. 单个请求单独配置（仅特定API使用长超时）

如果只有这个长耗时API需要特殊超时，可在请求链中单独设置，不影响全局配置：

String apiResponse = webClient.get()
        .uri("https://your-target-service.com/long-running-task")
        // 为当前请求单独设置读取超时
        .httpRequest(request -> {
            HttpClientRequest nativeRequest = request.getNativeRequest();
            nativeRequest.responseTimeout(Duration.ofMinutes(2));
        })
        .retrieve()
        .bodyToMono(String.class)
        .block();

关键超时项说明 #

• 连接超时：ChannelOption.CONNECT_TIMEOUT_MILLIS，控制建立TCP连接的最大等待时间，默认30秒无需修改。
• 读取超时：responseTimeout，控制从连接建立后，等待服务返回响应的最大时长，必须设置为你预期的服务处理完成时间（比如2分钟），避免提前中断请求导致数据处理不完整。
• 若你的请求是POST/PUT且包含大请求体，还可按需配置写入超时，但你的场景核心是等待响应，所以重点关注读取超时即可。

注意事项 #

• 不要用Thread.sleep()：这种方式会让当前线程无意义休眠，WebClient的超时配置由底层Reactor HttpClient管理，超时后会主动中断请求并释放资源，比手动休眠高效且可靠。
• 若服务处理时间可能波动，可适当设置比预期最长处理时间稍长的超时值，确保数据能完整处理。

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