4. 连接池水位异常类型：连接泄漏、连接饥饿、连接阻塞、连接超时、连接池打满

在 OAuth2.0 授权码模式与客户端凭证模式的典型部署中，授权服务器（AS）与资源服务器（RS）之间的通信、网关与令牌校验端点之间的交互，均依赖 HTTP 连接池。连接池的水位异常是导致 OAuth2.0 服务不可用的首要故障模式。本章系统梳理五种核心异常类型，帮助运维人员从现象快速定位根因。

4.1 五种异常类型总览

4.2 连接泄漏（Connection Leak）

连接泄漏是最隐蔽的异常。在 OAuth2.0 网关中，常见于 RestTemplate 或 HttpClient 的 Response 未正确关闭，导致 TCP 连接被长期占用而不归还连接池。

// 错误示例：未释放 Response 导致泄漏
public TokenInfo validateToken(String token) {
    CloseableHttpResponse response = null;
    try {
        response = httpClient.execute(new HttpGet(tokenEndpoint + token));
        // 只读取了状态码，未消费 Entity
        int status = response.getStatusLine().getStatusCode();
        return new TokenInfo(status == 200);
    } finally {
        // 缺少 response.close() 或 EntityUtils.consume()
    }
}

4.3 连接饥饿（Connection Starvation）

连接饥饿发生在池大小无法匹配瞬时并发时。OAuth2.0 令牌刷新风暴是典型诱因：大量客户端同时令牌过期，并发请求令牌端点，导致连接池瞬间被占满。

• 现象： 请求队列深度 > 0，ConnectionPoolTimeoutException 频发。
• 根因： maxTotal 或 defaultMaxPerRoute 配置过小。
• 快速恢复： 临时调大 maxTotal 并重启，但需同步排查是否因泄漏导致可用连接减少。

// 饥饿场景下的连接池配置调优示例
PoolingHttpClientConnectionManager cm = new PoolingHttpClientConnectionManager();
cm.setMaxTotal(200);           // 总连接数
cm.setDefaultMaxPerRoute(100); // 每路由最大连接数
// 令牌端点路由单独设置
HttpHost tokenHost = new HttpHost("as.example.com", 443, "https");
cm.setMaxPerRoute(new HttpRoute(tokenHost), 150);

4.4 连接阻塞（Connection Blocking）

连接阻塞与饥饿不同：阻塞是连接被慢请求“卡住”，而非池容量不足。在 OAuth2.0 中，若授权服务器响应缓慢（如数据库查询慢、JWT 签名计算阻塞），网关连接会被长时间占用，导致后续请求排队。

排查方法： 使用 curl -w "time_total:%{time_total}" 测试 AS 响应时间；若 AS 响应 > 1s，则网关连接池需配合 setConnectionRequestTimeout 和 setSocketTimeout 做熔断。

4.5 连接超时（Connection Timeout）

连接超时分为三个层次，在 OAuth2.0 故障排查中需分层定位：

故障案例： 某网关配置 connectionRequestTimeout=100ms，但令牌端点平均响应 200ms，导致每次请求都因获取连接超时而失败。调整至 500ms 后恢复。

4.6 连接池打满（Pool Exhausted）

连接池打满是前四种异常叠加的最终状态。此时 PoolingHttpClientConnectionManager 的 totalStats.leased 等于 maxTotal，所有新请求立即抛出异常。

// 打满时的异常堆栈特征
org.apache.http.conn.ConnectionPoolTimeoutException: Timeout waiting for connection from pool
    at org.apache.http.impl.conn.PoolingHttpClientConnectionManager.leaseConnection(PoolingHttpClientConnectionManager.java:316)
    at org.apache.http.impl.conn.PoolingHttpClientConnectionManager$1.get(PoolingHttpClientConnectionManager.java:282)

4.7 五种异常的关系与诊断流程

下图展示了五种异常在连接池生命周期中的演化路径与诊断决策树：

4.8 五种异常的快速定位对照表

掌握这五种异常类型的特征与诊断路径，是 OAuth2.0 连接池水位治理的基础。下一层我们将深入连接泄漏的代码级排查与修复实战。