spring 6 新增的 http interface 默认对阻塞式调用（如 `mono.block()`）设定了 5 秒硬性超时，即使底层 webclient 已配置更长的读超时，仍会因 `blocktimeout` 触发 `timeout on blocking read` 异常。
在 Spring 6 中，HttpServiceProxyFactory 通过 WebClientAdapter 封装响应式客户端，但其对外暴露的接口方法（如 @GetExchange）默认以阻塞方式执行——即内部调用 Mono.block(Duration) 等待结果。该阻塞操作的超时由 HttpServiceProxyFactory.Builder#blockTimeout(Duration) 控制，而非 WebClient 或 Netty 的连接/读超时。
关键点在于：
- HttpClient.create().option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 5000) 仅控制 TCP 连接建立超时；
- ReadTimeoutHandler(10000L, TimeUnit.MILLISECONDS) 仅控制网络层空闲读超时（即数据流中断后等待多久抛异常）；
- 而 Timeout on blocking read 报错中的 5000000000 NANOSECONDS（即 5 秒）正是 HttpServiceProxyFactory 的默认 blockTimeout 值，它独立于网络层，作用于 Mono.block() 调用本身。
✅ 正确解决方案：显式配置 blockTimeout，使其 ≥ 底层网络超时（推荐略大于读超时，留出序列化/处理余量）：
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
HttpClient httpClient = HttpClient.create()
.option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 5000)
.doOnConnected(conn ->
conn.addHandlerLast(new ReadTimeoutHandler(10_000, TimeUnit.MILLISECONDS))
);
WebClient webClient = WebClient.builder()
.clientConnector(new ReactorClientHttpConnector(httpClient))
.baseUrl(locationUrl.toExternalForm())
.build();
// ✅ 关键：设置 blockTimeout 为 12 秒（覆盖默认 5 秒）
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builder(
WebClientAdapter.forClient(webClient))
.blockTimeout(Duration.ofSeconds(12)) // ← 必须显式设置！
.build();
YourHttpInterface client = factory.createClient(YourHttpInterface.class);⚠️ 注意事项：
- blockTimeout 必须大于等于 ReadTimeoutHandler 设置的值（如本例中 12s > 10s），否则会在响应未返回前就因阻塞超时而中断；
- 若业务允许异步处理，建议直接使用 Mono
返回类型并链式响应式处理（如 .flatMap()、.onErrorResume()），彻底规避 block()； - 不要混淆 blockTimeout 与 WebTestClient 的测试超时注解（如 @AutoConfigureWebTestClient(timeout = "...")），后者仅影响测试上下文，对生产环境无影响；
- 在高并发场景下，过度依赖阻塞调用可能引发线程池耗尽，应结合 @Async 或 WebFlux 全栈响应式设计进行优化。
总结：Spring 6 HTTP Interface 的“阻塞超时”本质是 Mono.block() 的门控机制，需通过 HttpServiceProxyFactory.Builder.blockTimeout() 显式调整，这是与传统 RestTemplate 或纯 WebClient 完全不同的超时治理维度。
