4. 配置连接池上限：按业务场景调整最大空闲连接数

4.1 原理：为什么需要控制最大空闲连接数

OkHttp 连接池的核心参数 maxIdleConnections 决定了连接池中允许保留的最大空闲连接数。当实际空闲连接超过该值时，最近最少使用（LRU）的空闲连接会被关闭并释放资源。合理设置该参数直接影响：

• 内存占用：每个空闲连接持有 Socket、缓冲区（通常 64KB+），过多空闲连接浪费堆外内存。
• 连接建立延迟：空闲连接过少会导致高频请求反复建立 TCP 连接，增加延迟。
• 服务器连接压力：客户端保留过多空闲连接可能导致服务端连接数堆积，触发防火墙或连接限制。

4.2 实现流程：从默认值到业务级调优

1. 确认默认值：OkHttp 3.x/4.x 默认 maxIdleConnections = 5，keepAliveDuration = 5 分钟。
2. 评估业务拓扑：获取应用实际的后端服务数量（域名/IP 数量）以及单连接峰值复用数。
3. 设定目标值：
• 直连单点服务（1 台后端）：maxIdleConnections = 5 通常足够，可微调至 3~8。
• 多数据中心/多 VIP（3~5 台）：建议 maxIdleConnections = 总后端数 × 2，例如 3 台后端设为 6。
• 大量短连接、无连接复用（如纯 RestTemplate 转发）：适当降低至 2~3，避免空闲连接堆积。
4. 通过代码或配置设置：
5. 验证与调优：通过连接池监控 API 采集实际空闲连接数，结合 GC 日志调配参数。

4.3 代码实现：OkHttpClient 构造与配置

通过 ConnectionPool 构造函数设置最大空闲连接数：

// OkHttp 3.x / 4.x
import okhttp3.ConnectionPool;
import okhttp3.OkHttpClient;
import java.util.concurrent.TimeUnit;

// 设定最大空闲连接数为 8，保持存活时间 5 分钟
ConnectionPool pool = new ConnectionPool(8, 5, TimeUnit.MINUTES);

OkHttpClient client = new OkHttpClient.Builder()
        .connectionPool(pool)
        .build();

对于动态配置场景（如根据运行时环境调整），可以使用 ConnectionPool 的 setter 方法（OkHttp 4.x 支持重配置）：

// 运行时调整最大空闲连接数（OkHttp 4.x +）
ConnectionPool pool = client.connectionPool();
// 反射调用 setMaxIdleConnections 或使用 Kotlin 属性访问
// 推荐策略：重新创建 OkHttpClient 实例，旧池会自动 Drain
OkHttpClient newClient = client.newBuilder()
        .connectionPool(new ConnectionPool(10, 5, TimeUnit.MINUTES))
        .build();

4.4 调试与监控 API

OkHttp 提供了连接池内省方法，可用于运行时采集空闲连接数量：

// 获取连接池内部状态（Android / Java）
ConnectionPool pool = client.connectionPool();

// 空闲连接数（不含活跃连接）
int idleCount = pool.idleConnectionCount();

// 总连接数（空闲 + 活跃）
int totalCount = pool.connectionCount();

System.out.println("Idle: " + idleCount + " / Total: " + totalCount);

4.5 内联流程图：最大空闲连接数调整决策流程

4.6 常见错误与避坑

• 设置过小导致反复建连：maxIdleConnections=1 会使高并发场景下频繁创建新连接，增加延迟和 CPU 开销。
• 设置过大导致内存泄漏：空闲连接数量超过 20 时，堆外 DirectBuffer 可能快速增长，尤其在 Android 低端设备上引发 OOM。
• 不匹配服务端 Keep-Alive 超时：如果服务端 keepalive_timeout 小于客户端 keepAliveDuration，连接会被服务端提前关闭，客户端空闲连接实际上已不可用，造成“假空闲”。建议客户端 keepAliveDuration ≤ 服务端超时的 80%。

4.7 性能与稳定性优化建议

1. 结合 Keep-Alive Duration 同步调整：降低 keepAliveDuration 至 1~3 分钟可更快释放空闲连接，适合后端负载均衡器连接数敏感的场景。
2. 针对不同域名设置独立连接池：

// 为不同后端域名创建独立连接池
ConnectionPool apiPool = new ConnectionPool(5, 3, TimeUnit.MINUTES);
ConnectionPool authPool = new ConnectionPool(2, 5, TimeUnit.MINUTES);

OkHttpClient apiClient = new OkHttpClient.Builder()
        .connectionPool(apiPool)
        .build();

OkHttpClient authClient = new OkHttpClient.Builder()
        .connectionPool(authPool)
        .build();

• 利用 HTTP/2 复用降低空闲连接需求：HTTP/2 单连接支持多路复用，可将 maxIdleConnections 调低至 2~3。
• 定期 Drain 废弃连接：当系统进入低负载期（如夜间批处理结束），调用 connectionPool.evictAll() 强制清理空闲连接。

// 清理所有空闲连接
client.connectionPool().evictAll();