3. 连接池与超时联动：连接池复用原理、keep-alive超时对重试的影响、连接池参数调优

连接池复用是 OkHttp 高性能的基石，但 keep-alive 超时设置不合理会导致重试时复用失效、连接重建频繁，甚至引发雪崩。本章从连接池的内部结构出发，分析复用与超时的联动关系，并给出参数调优的量化建议。

3.1 连接池复用原理

OkHttp 的 ConnectionPool 维护一个 Deque<RealConnection> 双端队列，每个连接通过 host:port 作为复用键。当新请求到达时，池中查找匹配的空闲连接，命中则直接绑定到 RealCall；未命中则新建连接并放入池中。

连接池的清理由独立的后台线程触发，每 60 秒轮询一次，移除超过 keepAliveDuration 的空闲连接。默认 maxIdleConnections = 5，keepAliveDuration = 5 分钟。

3.2 keep-alive 超时对重试的影响

keep-alive 超时是连接池与重试之间最关键的耦合点。当请求重试发生时，如果池中的连接已因空闲超时被关闭，重试时必须重新创建 TCP 连接，这会增加延迟并可能触发新的超时。

3.3 连接池参数调优

连接池参数需要根据业务并发模型、平均请求间隔、服务端 keep-alive 配置综合设定。以下是核心参数及其调优建议：

在 OkHttp 中配置连接池与超时参数的示例：

OkHttpClient client = new OkHttpClient.Builder()
    .connectionPool(new ConnectionPool(20, 3, TimeUnit.MINUTES))
    .connectTimeout(8, TimeUnit.SECONDS)
    .readTimeout(15, TimeUnit.SECONDS)
    .writeTimeout(15, TimeUnit.SECONDS)
    .retryOnConnectionFailure(true)
    .build();

3.4 调试与验证

使用 OkHttp 的 EventListener 可以精确观察连接池的命中与超时事件。注册自定义监听器输出关键日志：

class ConnectionPoolListener extends EventListener {
    @Override
    public void connectionAcquired(Call call, Connection connection) {
        System.out.println("[连接获取] " + connection.socket().getRemoteSocketAddress());
    }

    @Override
    public void connectionReleased(Call call, Connection connection) {
        System.out.println("[连接释放] " + connection.socket().getRemoteSocketAddress());
    }

    @Override
    public void connectFailed(
            Call call, InetSocketAddress inetSocketAddress,
            Protocol protocol, IOException ioe) {
        System.err.println("[连接失败] " + inetSocketAddress + " " + ioe.getMessage());
    }
}

OkHttpClient client = new OkHttpClient.Builder()
    .eventListener(new ConnectionPoolListener())
    .build();

运行测试请求后观察日志输出，验证连接复用是否生效：

[连接获取] /192.168.1.100:443
[连接释放] /192.168.1.100:443
[连接获取] /192.168.1.100:443    ← 同一地址，复用成功
[连接释放] /192.168.1.100:443

如果每次请求都出现 connectFailed 或始终未出现复用日志，说明连接池配置与业务模型不匹配，需要调整 keepAliveDuration 或 maxIdleConnections。