Spring WebFlux WebClient超时配置失效问题求助

嘿，我在早期Spring Boot版本里踩过一模一样的坑——WebClient默认的30秒超时简直像个甩不掉的尾巴，明明改了配置却死活不生效。结合你用的2.0.0.M7版本，咱们来一步步把它搞定：

1. 精准配置Reactor Netty的超时参数 #

你之前用clientConnector没生效，大概率是没抓对早期版本的配置逻辑。在2.0.0.M7里，WebClient默认依赖Reactor Netty的HttpClient，必须手动配置TcpClient的超时参数，再绑定到WebClient的连接器上：

import org.springframework.http.client.reactive.ReactorClientHttpConnector;
import reactor.netty.http.client.HttpClient;
import reactor.netty.tcp.TcpClient;
import io.netty.channel.ChannelOption;
import io.netty.handler.timeout.ReadTimeoutHandler;
import io.netty.handler.timeout.WriteTimeoutHandler;

@Bean
public WebClient customWebClient() {
    // 先配置TCP层面的超时
    TcpClient tcpClient = TcpClient.create()
            // 连接超时：10秒（单位毫秒）
            .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 10000)
            // 连接建立后，配置读写超时（单位秒，这个版本里Handler参数是秒）
            .doOnConnected(conn ->
                    conn.addHandlerLast(new ReadTimeoutHandler(20))
                        .addHandlerLast(new WriteTimeoutHandler(20)));

    // 基于配置好的TcpClient构建HttpClient
    HttpClient httpClient = HttpClient.from(tcpClient);

    // 把自定义HttpClient绑定到WebClient
    return WebClient.builder()
            .clientConnector(new ReactorClientHttpConnector(httpClient))
            .build();
}

这里要注意：早期Reactor Netty的ReadTimeoutHandler和WriteTimeoutHandler参数是秒，不是后来版本的毫秒，别搞错单位导致超时时间不符合预期。

2. 确保自定义配置覆盖默认值 #

Spring Boot的自动配置可能会生成默认的WebClient实例，如果你的自定义Bean没被优先加载，还是会用默认的30秒超时。给你的WebClient Bean加上@Primary注解，确保它成为容器的首选：

@Bean
@Primary
public WebClient customWebClient() {
    // 同上配置代码
}

3. 验证配置是否生效 #

别光改配置就完事，得验证一下：

• 写个测试接口，模拟一个超过你设置超时时间的响应（比如30秒后返回），看是否会在你设置的时间（比如20秒）触发超时。
• 开启Reactor Netty的调试日志，在application.properties里加：

  logging.level.reactor.netty=DEBUG
  

  然后看日志里的TCP连接配置，确认你设置的超时参数已经被应用。

4. 避开版本兼容坑 #

你用的是2.0.0.M7这个里程碑版本，很多新版的API还没上线，别尝试用后来的简化写法（比如HttpClient.responseTimeout()），这些在你的版本里根本不支持，必须用TcpClient的option和Handler来配置。

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