4. 连接池泄漏检测：连接未归还、事务超时、连接池耗尽、常见泄漏场景分析

连接池泄漏是分布式事务场景中最隐蔽、破坏力最强的故障模式之一。当数据库连接被业务线程获取后，由于异常分支、事务悬挂或代码缺陷未能正确归还连接池，会导致连接池水位持续上升，最终引发连接池耗尽、服务雪崩。本章从泄漏的四种核心表现入手，结合Saga编排场景，给出可落地的检测与定位方法。

4.1 连接池泄漏的四种核心表现

连接池泄漏并非单一现象，而是从连接未归还到连接池耗尽的一系列连锁反应。下表总结了四种表现及其在Saga事务中的典型触发场景：

4.2 连接未归还：最隐蔽的泄漏源头

连接未归还通常发生在以下代码模式中：

• 异常路径未释放：业务代码在try块中获取连接，catch块中直接throw，遗漏finally中的close()。
• 线程池与连接池混用：异步回调中获取连接，但回调线程被丢弃，连接无法自动归还。
• Saga补偿事务中的连接泄漏：补偿逻辑中再次调用数据库操作，但未使用新的连接或未正确释放。

// HikariCP 泄漏检测配置示例
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/saga_db");
config.setMaximumPoolSize(20);
config.setConnectionTimeout(30000);
config.setLeakDetectionThreshold(60000); // 连接持有超过60秒视为泄漏
config.setPoolName("SagaPool");

4.3 事务超时：连接被数据库端强制回收

事务超时与连接池泄漏存在直接关联：当事务执行超过数据库或连接池的超时阈值时，数据库会主动断开连接，但连接池中的Connection对象可能仍处于“活跃”状态，导致连接池认为该连接仍在使用中，无法被回收。

常见超时参数及其影响：

4.4 连接池耗尽：从泄漏到雪崩

当连接未归还和事务超时累积到一定程度，连接池将进入耗尽状态。此时所有线程都在等待获取连接，形成线程阻塞→请求堆积→服务不可用的雪崩效应。

连接池耗尽的典型水位曲线：

1. 潜伏期：连接池水位在70%-80%波动，偶发短暂峰值。
2. 爬升期：泄漏连接数量增加，水位持续上升至90%以上。
3. 耗尽期：水位达到100%，新请求获取连接超时，抛出ConnectionTimeoutException。
4. 雪崩期：大量线程阻塞在获取连接上，CPU飙升，服务整体不可用。

4.5 常见泄漏场景深度分析

以下四个场景是Saga分布式事务中最常出现的连接池泄漏模式，每个场景都配有检测方法：

4.5.1 场景一：补偿事务中的连接未释放

Saga协调器调用补偿事务时，如果补偿逻辑中又调用了数据库操作，但未在finally中释放连接，就会产生泄漏。尤其在补偿事务本身抛出异常时，连接更容易被遗忘。

// 错误示例：补偿事务中连接泄漏
public void compensate(String txId) {
    Connection conn = dataSource.getConnection(); // 获取连接
    try {
        PreparedStatement ps = conn.prepareStatement("UPDATE account SET balance = balance + ? WHERE id = ?");
        ps.setBigDecimal(1, new BigDecimal("100"));
        ps.setString(2, "user_001");
        ps.executeUpdate();
        // 如果这里抛出异常，conn 不会释放
    } catch (SQLException e) {
        log.error("补偿事务失败", e);
        throw new RuntimeException(e); // 抛出异常，但 conn 未关闭
    }
    // 缺少 finally { conn.close(); }
}

4.5.2 场景二：空补偿与悬挂事务

当Saga参与方收到补偿请求时，如果本地事务尚未执行（空补偿），或者事务已提交但补偿请求延迟到达（悬挂事务），都会导致连接被异常持有。空补偿场景中，参与方可能尝试查询不存在的本地事务记录，查询连接未释放；悬挂事务中，补偿事务与本地事务同时操作数据库，产生锁等待，连接被长时间阻塞。

4.5.3 场景三：异步回调中的连接逃逸

使用@Async或消息队列进行Saga异步回调时，子线程获取的连接如果未在回调完成后释放，且线程池拒绝策略为DiscardPolicy，连接将永远无法归还。

4.5.4 场景四：连接池参数配置不当

minimumIdle设置过高会导致空闲连接过多；maxLifetime设置过长会导致连接池中堆积大量“僵尸连接”；validationTimeout过短会导致连接被误判为不可用，频繁重建连接。

4.6 连接池泄漏巡检清单

以下是Saga分布式事务场景下的连接池泄漏巡检标准操作步骤：