HttpClient4迁移至HttpClient5：SocketTimeout配置相关问题解析

问题1：PoolingHttpClientConnectionManager中ConnectionConfig.setSocketTimeout与SocketConfig.setSoTimeout的区别 #

• SocketConfig.setSoTimeout：对应JDK原生Socket.setSoTimeout(int)，是底层TCP Socket的核心属性。当Socket处于阻塞状态等待数据时，超过设定时长仍未收到数据，会直接抛出SocketTimeoutException，属于纯TCP层面的基础超时控制。
• ConnectionConfig.setSocketTimeout：是HttpClient5封装的连接级读取超时，用于定义连接池内连接执行请求时，读取响应数据的默认最大等待时长。它是框架层面的配置，最终会映射到底层Socket的SO_TIMEOUT属性，但优先级高于SocketConfig的配置。

问题2：HttpClient4的RequestConfig.setSocketTimeout对应HttpClient5的哪个配置？ #

HttpClient4中RequestConfig.setSocketTimeout定义的是请求级读取超时（等待服务器返回响应数据的超时），在HttpClient5中直接对应RequestConfig.setSocketTimeout。如果需要设置连接池的默认读取超时（替代HttpClient4中连接池的全局默认RequestConfig），则对应ConnectionConfig.setSocketTimeout，而非SocketConfig的soTimeout。

问题3：SocketConfig与ConnectionConfig的超时配置是否需要重复设置？优先级如何？ #

无需重复设置，三者（请求级配置、ConnectionConfig、SocketConfig）的优先级从高到低为：

1. 请求级配置：若单个请求单独设置了RequestConfig.setSocketTimeout，会直接覆盖所有池级默认配置；
2. ConnectionConfig：未设置请求级超时的情况下，ConnectionConfig.setSocketTimeout会作为连接池内所有连接的默认读取超时，此时会覆盖SocketConfig的soTimeout；
3. SocketConfig：前两者均未配置时，才会使用SocketConfig.setSoTimeout作为底层Socket的兜底超时。

响应超时相关补充 #

所谓响应超时，本质就是上述的读取超时（socketTimeout），即客户端等待服务器返回响应数据的最大时长。在HttpClient5中，无论是请求级的RequestConfig.setSocketTimeout，还是连接池默认的ConnectionConfig.setSocketTimeout，都是用来控制这个响应超时的。

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