spring 6 新增的 http interface 在使用 `@getexchange` 等注解时，默认对响应执行 5 秒阻塞等待，若后端响应慢于该值便会抛出 `timeout on blocking read` 异常——此超时独立于 http 连接/读取超时，需显式通过 `blocktimeout()` 配置调整。
Spring 6 引入的 HTTP Interface 是一种声明式、类型安全的 REST 客户端抽象，底层基于 WebClient，但其同步调用行为（如接口方法直接返回 AvailabilityResponse）实际是通过 Reactor 的 Mono.block() 实现的。关键点在于：这个 block() 操作自带默认超时（5 秒），且该超时与网络层的 ConnectTimeout 或 ReadTimeoutHandler 完全无关。
从堆栈跟踪可清晰看到异常源头：
at reactor.core.publisher.Mono.block(Mono.java:1734) at org.springframework.web.service.invoker.HttpServiceMethod$ResponseFunction.execute(HttpServiceMethod.java:296)
这表明：即使你已为 HttpClient 正确配置了 ReadTimeoutHandler(10_000)，只要 Mono.block() 在 5 秒内未收到信号，就会立即抛出 IllegalStateException: Timeout on blocking read for 5000000000 NANOSECONDS（即 5 秒 = 5,000,000,000 纳秒）。
✅ 正确解决方案：使用 HttpServiceProxyFactory.Builder.blockTimeout()
阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。
在构建代理工厂时，显式设置 blockTimeout 以匹配你的业务预期（例如 10 秒）：
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();
// ✅ 关键：覆盖默认 5 秒阻塞超时
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builder(
WebClientAdapter.forClient(webClient))
.blockTimeout(Duration.ofSeconds(10)) // ← 显式设为 10 秒，与 ReadTimeoutHandler 一致
.build();
// 创建代理实例
AvailabilityClient client = factory.createClient(AvailabilityClient.class);⚠️ 注意事项：
- blockTimeout() 仅影响同步接口方法（即返回非 Mono/Flux 的方法）。若接口返回 Mono
，则不会触发 block()，自然不涉及此超时。 - 该配置必须在 HttpServiceProxyFactory.builder() 阶段设置，无法在运行时动态修改。
- 建议将 blockTimeout 值略大于网络层 ReadTimeoutHandler（如后者 10 秒，前者设为 12 秒），为序列化、反序列化等客户端处理留出余量。
- 生产环境应优先考虑异步编程模型（返回 Mono/Flux），避免阻塞调用；blockTimeout 仅适用于遗留同步场景或测试集成。
总结：Spring 6 HTTP Interface 的“阻塞读取超时”本质是 Reactor Mono.block() 的硬编码默认值，解决它不需要调整 Netty 或 WebClient 底层参数，只需在 HttpServiceProxyFactory.Builder 中调用 .blockTimeout(Duration) 即可精准控制——这是官方设计提供的标准扩展点，简洁、明确且符合响应式编程原则。
