Apache HTTP异步客户端：RequestConfig与IOReactorConfig超时配置差异

你困惑这两个配置的超时很正常——它们确实管着不同层面的东西，不是简单的重复配置，我来给你掰扯清楚：

1. 作用层级完全不同 #

• IOReactorConfig：这是全局的、底层IO层面的配置，属于整个异步HttpClient实例的基础设置，所有请求默认都会继承这里的参数。它管的是TCP Socket层面的底层操作，相当于给整个客户端的IO反应器定好基础规则。
• RequestConfig：这是请求级别的、HTTP流程层面的配置，可以为每个单独的请求量身定制，它的设置会覆盖IOReactorConfig里的对应全局参数，同时还包含一些IOReactorConfig没有的、和HTTP请求流程相关的参数。

2. 具体超时参数的分工 #

IOReactorConfig 里的超时（底层Socket级） #

• connectTimeout：TCP连接建立的超时时间（就是三次握手的时间限制）。比如你设置为5秒，那客户端和服务器建立TCP连接时，如果5秒内没完成握手，就会超时。这是所有请求的默认值，除非单个请求用RequestConfig覆盖。
• soTimeout：Socket的读取超时。指的是底层Socket在等待接收数据时，如果超过这个时间还没收到任何数据，就会触发超时。这是Socket层面的单次读取操作的超时，是全局默认的。

RequestConfig 里的超时（HTTP请求流程级） #

• connectTimeout：覆盖全局的IOReactorConfig.connectTimeout，针对当前这个请求单独设置TCP连接超时。比如全局默认5秒，这个请求你可以设成10秒，优先级更高。
• connectionRequestTimeout：这个是RequestConfig独有的！当你用连接池管理连接时，这个参数控制从连接池获取可用连接的超时时间。比如连接池里所有连接都被占用了，客户端等待新连接释放的时间超过这个值，就会抛出超时异常——这个参数和底层IO无关，是连接池调度层面的，IOReactorConfig根本管不到。
• socketTimeout：HTTP请求的读取超时，本质上是映射到底层Socket的soTimeout，但它是请求级别的设置。也就是说，你可以给不同的请求设置不同的读取超时，比如下载大文件的请求设60秒，普通接口设10秒，都会覆盖全局的IOReactorConfig.soTimeout。

3. 总结：怎么用？ #

• 如果你想给所有请求设置统一的底层IO超时，就配置IOReactorConfig，作为全局默认。
• 如果某个请求需要特殊的超时（比如更长的连接超时、读取超时），或者需要设置连接池获取超时，就单独给这个请求配置RequestConfig，它会覆盖全局设置。
• 两者不是二选一，而是配合使用：全局配置兜底，请求配置个性化定制。

举个简单的代码例子（补全你没写完的片段）：

// 全局IO reactor配置
IOReactorConfig ioReactorConfig = IOReactorConfig.custom()
        .setConnectTimeout(5000) // 全局默认TCP连接超时5秒
        .setSoTimeout(10000) // 全局默认Socket读取超时10秒
        .build();

// 异步客户端实例
CloseableHttpAsyncClient httpClient = HttpAsyncClients.custom()
        .setDefaultIOReactorConfig(ioReactorConfig)
        .build();

// 单个请求的定制配置
RequestConfig requestConfig = RequestConfig.custom()
        .setConnectTimeout(10000) // 这个请求用10秒连接超时，覆盖全局
        .setConnectionRequestTimeout(3000) // 从连接池拿连接最多等3秒
        .setSocketTimeout(60000) // 这个请求读取超时60秒，覆盖全局
        .build();

// 给请求绑定定制配置
HttpGet request = new HttpGet("http://example.com/large-file");
request.setConfig(requestConfig);

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