Apache HttpClient 5.1.x各类超时区别及配置选型咨询

核心区别与适用场景 #

1. ConnectionRequestTimeout

• 作用：控制从请求连接池获取可用连接的等待时长。当连接池里所有连接都被占用时，新的请求会进入等待队列，这个超时就是队列等待的最长时间。
• 触发场景：并发请求数超过连接池最大容量，排队等不到空闲连接时，会抛出ConnectionPoolTimeoutException。

2. ConnectTimeout

• 作用：控制TCP连接建立阶段的耗时。也就是从HttpClient拿到空闲连接后，和目标服务器完成TCP三次握手的最长时间。
• 触发场景：目标服务器网络不可达、延迟过高，或者域名解析缓慢时，会抛出ConnectTimeoutException。

附带解释代码里的其他超时参数 #

• SocketTimeout（SoTimeout）：TCP连接建立后，等待服务器发送数据的最大间隙时间。比如服务器响应过程中突然长时间没发数据，超过这个值就会触发超时，抛出SocketTimeoutException。
• ResponseTimeout（HttpClient 5.x新增）：控制从请求发送到收到完整响应的总时长，覆盖了连接、数据传输等整个流程的总耗时，超时后抛出HttpRequestTimeoutException。

你的配置代码 #

RequestConfig requestConfig =
          RequestConfig.custom()
              .setConnectionRequestTimeout(10)
              .setConnectTimeout(10)
              .setSocketTimeout(10)
              .setResponseTimeout(10)
              .build();

注意：你设置的10毫秒超时过于极端，实际业务场景中建议根据网络情况调整，比如连接请求超时设为500毫秒，连接超时设为3秒等，避免正常请求被误判超时。

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