Apache Async HttpClient5中responseTimeout不生效问题排查

核心错误点 #

1. Future.get()无参调用导致无限阻塞
   你调用responseFuture.get()时未设置超时时间，该方法的无参版本会持续阻塞线程，直到Future完成（成功/失败），完全忽略RequestConfig中配置的responseTimeout。即便请求触发超时并进入failed回调，若无get()的超时限制，线程仍会无限等待。

2. 请求超时配置需配合Future超时生效
   RequestConfig中的responseTimeout是HttpAsyncClient层面的请求响应超时，触发后会调用failed回调并标记Future为失败状态，但这不会主动中断get()的阻塞，必须通过get()的超时参数强制终止等待。

修复代码 #

步骤1：给Future.get()添加超时参数 #

将无参的get()调用改为带超时的版本，超时时间与你设置的requestTimeout保持一致：

SimpleHttpResponse simpleHttpResponse = responseFuture.get(
    requestTimeout.getTimeoutInMs(), 
    TimeUnit.MILLISECONDS
);

这样即使客户端内部的超时逻辑未及时触发，get()也会在指定时间后抛出TimeoutException，避免无限等待。

步骤2：确保请求超时配置正确生效 #

你的代码中SimpleRequestProducer.create(simpleRequestBuilder.build())已经传递了包含超时配置的请求对象，这部分是正确的。当请求超过responseTimeout未收到响应时，客户端会自动触发failed回调，此时get()会抛出ExecutionException，你可以捕获该异常处理超时场景。

额外说明 #

• 不同请求设置不同超时的需求可以通过该方式实现：每个请求单独构建RequestConfig设置响应超时，再配合对应超时时间的Future.get()调用即可。
• 注意区分responseTimeout和connectionRequestTimeout：前者是请求发送后等待响应的超时，后者是从连接池获取连接的超时，两者作用阶段不同。

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