Spring Boot 3 WebClient.Builder默认超时、运行时选择及配置疑问

1. WebClient 默认客户端选择与强制切换 #

• 当前环境下默认用Reactor Netty：因为你引入了spring-boot-starter-webflux，这个starter默认包含Reactor Netty依赖，Spring Boot的自动配置会优先选择Netty作为WebClient的底层客户端。
• 文档提及JDK HttpClient的原因：Spring Boot的自动配置是类路径驱动的——如果类路径里没有Reactor Netty（比如手动排除了相关依赖），就会自动切换到Java 17自带的JDK HttpClient（Java 11+原生支持异步HTTP客户端），这是为了提供 fallback 选项。
• 强制使用JDK HttpClient的两种方式：
  • 方式一：排除Reactor Netty依赖（以Maven为例）：

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-webflux</artifactId>
        <exclusions>
            <exclusion>
                <groupId>io.projectreactor.netty</groupId>
                <artifactId>reactor-netty-http</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    

  • 方式二：自定义ClientHttpConnector Bean，直接指定用JDK HttpClient：

    @Bean
    public ClientHttpConnector jdkClientHttpConnector() {
        HttpClient jdkHttpClient = HttpClient.newBuilder()
                .connectTimeout(Duration.ofSeconds(10)) // 可顺便设置超时
                .build();
        return new JdkClientHttpConnector(jdkHttpClient);
    }
    

    Spring Boot会自动把这个连接器注入到预配置的WebClient.Builder中。

2. WebClient.Builder 默认连接超时与源码位置 #

• 预配置的WebClient.Builder本身没有设置默认连接超时，它会直接沿用底层客户端的默认值：
  • 如果用Netty，默认连接超时是30秒，对应Reactor Netty源码中reactor.netty.http.client.HttpClient类的DEFAULT_CONNECT_TIMEOUT常量（值为Duration.ofSeconds(30)）。
  • 如果用JDK HttpClient，默认连接超时是无穷大（没有超时限制），对应JDK的HttpClient.Builder默认配置。
• 查看源码路径：Spring Boot的自动配置类org.springframework.boot.autoconfigure.web.reactive.function.client.WebClientAutoConfiguration，里面的webClientBuilder()方法只会初始化Builder，不会主动设置超时；超时逻辑完全由底层ClientHttpConnector实现。

3. 保留预配置仅覆盖连接超时 #

你可以通过自定义WebClient Bean的方式，注入Spring Boot自动配置好的WebClient.Builder，在其基础上修改超时设置，不破坏原有预配置（比如默认的消息转换器、拦截器等）：

针对Netty客户端的情况： #

@Bean
public WebClient customWebClient(WebClient.Builder webClientBuilder) {
    HttpClient nettyHttpClient = HttpClient.create()
            .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 10000) // 连接超时10秒
            .responseTimeout(Duration.ofSeconds(15)); // 可选：设置响应超时
    return webClientBuilder
            .clientConnector(new ReactorClientHttpConnector(nettyHttpClient))
            .build();
}

针对JDK HttpClient的情况： #

@Bean
public WebClient customWebClient(WebClient.Builder webClientBuilder) {
    HttpClient jdkHttpClient = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();
    return webClientBuilder
            .clientConnector(new JdkClientHttpConnector(jdkHttpClient))
            .build();
}

这种方式会保留自动配置给WebClient.Builder带来的所有特性（比如通过spring.webclient.*配置的全局参数），仅替换连接器的超时设置。

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