Apache HttpClient连接池满配但全可用问题排查求助

我配置了带SSL的PoolingHttpClientConnectionManager，代码如下：

private PoolingHttpClientConnectionManager getConnManager(
    Registry<ConnectionSocketFactory> socketFactoryRegistry) {
  PoolingHttpClientConnectionManager connectionManager =
      new PoolingHttpClientConnectionManager(socketFactoryRegistry);

  connectionManager.setDefaultMaxPerRoute(configProperties.getConnectionPool().getMaxPerRoute());
  connectionManager.setMaxTotal(configProperties.getConnectionPool().getMaxTotal());
  return connectionManager;
}

连接池最大连接数设为1000，但出现了无法理解的日志：

[total available: 1000; route allocated: 1000 of 1000; total allocated: 1000 of 1000]

为什么会同时存在1000个可用连接，又达到1000个已分配上限？

我自定义了KeepAliveStrategy为5秒，本以为闲置的已分配连接会在5秒后释放：

.setKeepAliveStrategy((response, context) -> configProperties.getKeepAlive().toMillis())

而且从未见过[total available: 0; route allocated: 1000 of 1000; total allocated: 1000 of 1000]这类日志，不清楚连接池是如何被占满的。

补充场景：该HttpClient传入HttpComponentsMessageSender，再注入WebServiceTemplate用于SOAP调用，使用SSL加密，负载约为每分钟100次请求。相关代码：

JAXBElement result = (JAXBElement) webServiceTemplate.marshalSendAndReceive(url, request);

WebServiceTemplate webServiceTemplate = new WebServiceTemplate();
webServiceTemplate.setMarshaller(marshaller());
webServiceTemplate.setUnmarshaller(marshaller());
webServiceTemplate.setMessageSender(httpComponentsMessageSender);
webServiceTemplate.setInterceptors(interceptors.toArray(new ClientInterceptor[0]));
return webServiceTemplate;

HttpComponentsMessageSender httpComponentsMessageSender = new HttpComponentsMessageSender();
httpComponentsMessageSender.setHttpClient(httpClient());
return httpComponentsMessageSender;

var sslsf = sslConnectionSocketFactory();
var socketFactoryRegistry =
    RegistryBuilder.<ConnectionSocketFactory>create().register("https", sslsf).build();

var baseHttpClient =
    HttpClientBuilder.create()
        .setRetryHandler(
            (exception, executionCount, context) -> {
              if (exception instanceof InterruptedIOException) {
                // Logic for transforming timeout exceptions to handled exceptions
              }
              return false; // Do not retry
            })
        .setDefaultRequestConfig(
            RequestConfig.custom()
                .setConnectTimeout(
                    (int) configProperties.getTimeoutConfig().getConnect().toMillis())
                .setSocketTimeout(
                    (int) configProperties.getTimeoutConfig().getSocket().toMillis())
                .setConnectionRequestTimeout(
                    (int) configProperties.getTimeoutConfig().getRequestConnect().toMillis())
                .build())
        .setSSLSocketFactory(sslsf)
        .addInterceptorFirst(new RemoveSoapHeadersInterceptor())
        .setConnectionManager(getConnManager(socketFactoryRegistry))
        .setKeepAliveStrategy((response, context) -> configProperties.getKeepAlive().toMillis())
        .setConnectionTimeToLive(configProperties.getTtl().toMinutes(), TimeUnit.MINUTES)
        .build();

总结：没有1000个活跃连接，但连接池始终满配占用资源，预期逻辑是无可用连接时新建，闲置连接5秒后释放，但实际未生效，KeepAliveStrategy设置无效，求原因及解决办法。

核心原因 #

1. KeepAliveStrategy作用误解：该策略仅控制HTTP响应头中的Keep-Alive时长，告知服务器连接可保持的时间，但不会主动关闭或回收客户端连接池中的闲置连接。连接池的连接回收依赖内部清理机制，而非此策略。
2. 连接池自动清理未启用：PoolingHttpClientConnectionManager默认不会自动清理过期/闲置连接，需手动触发或配置定时任务。连接被分配后，即使闲置，只要未被清理，就会一直占用total allocated名额，同时处于available状态。
3. ConnectionTimeToLive的局限性：该参数是从连接创建时开始计算的存活时长，而非闲置时长。只要连接未达到TTL时间，即使长期闲置也不会被回收。

具体解决步骤 #

1. 启用连接池定时清理机制 #

调用PoolingHttpClientConnectionManager的清理方法，定时回收闲置/过期连接：

// 用定时线程池执行清理任务
ScheduledExecutorService scheduler = Executors.newSingleThreadScheduledExecutor();
scheduler.scheduleAtFixedRate(() -> {
    connectionManager.closeExpiredConnections();
    // 关闭闲置超过5秒的连接，与自定义KeepAlive时长匹配
    connectionManager.closeIdleConnections(5, TimeUnit.SECONDS);
}, 0, 1, TimeUnit.SECONDS); // 每秒执行一次清理

如果是Spring环境，可直接使用@Scheduled注解实现定时任务，更简洁。

2. 下调连接池参数适配负载 #

当前负载为每分钟100次请求，1000的连接数明显过高，建议将maxTotal和defaultMaxPerRoute下调至50-100区间，避免不必要的资源占用。

3. 确认连接释放逻辑无泄漏 #

检查WebServiceTemplate和HttpComponentsMessageSender的异常处理逻辑，确保所有请求（包括异常场景）都能正确释放连接回池。若存在未处理的IO异常，可能导致连接无法正常回收。

4. 明确两类策略的分工 #

• KeepAliveStrategy：控制服务器端的连接保持时长，服务器可能在超时后主动关闭连接，客户端连接池会检测到失效并清理。
• 连接池闲置回收：客户端主动清理长时间闲置的连接，不依赖服务器动作，这才是控制客户端连接池空闲连接数量的核心手段。

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