OkHttp ConnectionPool：如何设置连接池内连接的最大存活时长（TTL）

原生功能限制 #

OkHttp 默认的 ConnectionPool 仅支持配置空闲超时（idleTimeout）和最大空闲连接数（maxIdleConnections），没有直接提供“连接总存活时长”的配置项。默认逻辑下，只要连接空闲时间未超过阈值，就会留在池中等待复用，不会基于连接的创建时长强制回收。

自定义实现连接总存活时长限制 #

如果需要强制连接在创建后30秒内关闭（无论空闲状态），可以通过监听连接生命周期+自定义连接池逻辑实现：

1. 记录连接创建时间 #

通过 EventListener 监听连接的获取事件，记录每个连接的创建时间：

class TimedConnectionEventListener extends EventListener {
    private final Map<Connection, Long> connectionCreationTimes = new ConcurrentHashMap<>();

    @Override
    public void connectionAcquired(Call call, Connection connection) {
        // 首次获取连接时初始化创建时间
        connectionCreationTimes.computeIfAbsent(connection, k -> System.currentTimeMillis());
    }

    public Long getCreationTime(Connection connection) {
        return connectionCreationTimes.get(connection);
    }
}

2. 自定义连接池拦截放回逻辑 #

重写 ConnectionPool 的 put 方法，在连接放回池前检查总存活时长，超过阈值则直接关闭：

class TimedConnectionPool extends ConnectionPool {
    private static final long MAX_LIFETIME = 30_000; // 30秒
    private final TimedConnectionEventListener listener;

    public TimedConnectionPool(TimedConnectionEventListener listener) {
        super(); // 可按需传入maxIdleConnections和idleTimeout参数
        this.listener = listener;
    }

    @Override
    public boolean put(RealConnection connection) {
        Long creationTime = listener.getCreationTime(connection);
        if (creationTime != null && System.currentTimeMillis() - creationTime > MAX_LIFETIME) {
            // 标记连接不再接受新请求
            connection.noNewExchanges();
            // 安静关闭连接，连接池会自动移除该连接
            connection.closeQuietly();
            return false; // 不将连接放回池
        }
        return super.put(connection); // 正常放回池复用
    }
}

注意：RealConnection 是OkHttp内部类，若无法直接访问，可通过反射获取（需注意版本兼容性），或优先通过拦截器配合监听实现。

3. 配置OkHttpClient使用自定义组件 #

将自定义的监听器和连接池绑定到OkHttpClient：

TimedConnectionEventListener eventListener = new TimedConnectionEventListener();
TimedConnectionPool connectionPool = new TimedConnectionPool(eventListener);

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

主动关闭并移除连接的方法 #

要让OkHttp关闭指定连接并从池中移除，需执行两步操作：

• 调用 connection.noNewExchanges()：标记该连接不再接受新请求，避免被后续请求复用。
• 调用 connection.closeQuietly()：安静关闭连接，连接池会自动检测并移除已关闭的连接。

如果需要批量清理所有连接，可直接调用 ConnectionPool.evictAll() 方法。

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