3. 连接池水位概念
连接池水位是衡量数据库连接资源使用深度的核心指标，直接决定了分布式事务在并发场景下的资源竞争程度与系统稳定性。理解水位定义、高低水位阈值及其对吞吐与延迟的影响，是进行连接池巡检与Saga编排调优的前提。
3.1 水位定义
连接池水位指当前已分配连接数占连接池最大容量的百分比，反映了连接资源的占用深度。水位越高，剩余可用连接越少，新请求获取连接的等待概率越大。
| 术语 | 定义 | 计算公式 |
|---|---|---|
| 当前水位 | 某一时刻已分配的连接数 | active + idle_checked_out |
| 水位百分比 | 已分配连接数占最大连接数的比例 | (已分配 / maxTotal) × 100% |
| 安全水位 | 系统可稳定运行的水位上限（通常 ≤ 70%） | 经验值或压测获得 |
| 警戒水位 | 触发告警与自动扩容的水位阈值（通常 ≥ 85%） | 根据SLA设定 |
巡检要点： 水位百分比应结合连接获取等待时间（connection acquire timeout）一起观察。水位高但等待时间低，说明连接复用效率高；水位高且等待时间持续上升，说明连接池已过载。
3.2 高水位与低水位
高水位与低水位是连接池巡检中两个关键的监控边界，分别对应资源紧张与资源闲置两种状态。
- 高水位（High Watermark）：连接使用率达到或超过预设阈值（如85%），系统进入资源紧张区。此时新连接请求可能排队，事务响应时间开始明显增加。
- 低水位（Low Watermark）：连接使用率低于预设阈值（如20%），系统处于资源充裕区。但过低的水位可能意味着连接池配置过大或业务负载不足，存在资源浪费。
| 对比维度 | 高水位（≥85%） | 低水位（≤20%） |
|---|---|---|
| 资源状态 | 紧张，接近瓶颈 | 充裕，存在闲置 |
| 请求等待概率 | 高，容易超时 | 低，几乎无等待 |
| 系统吞吐 | 可能已达上限 | 有提升空间 |
| 事务延迟 | 明显增加 | 稳定且低 |
| 巡检动作 | 触发告警、扩容或限流 | 评估是否缩容或调整连接池参数 |
常见误区： 低水位并不总是好事。如果水位长期低于20%，但业务请求量并未下降，说明连接池的
maxTotal 设置过大，或连接泄漏导致连接被无效占用。此时应检查连接泄漏与空闲回收策略。
3.3 水位对系统吞吐与延迟的影响
水位变化直接影响系统的吞吐能力与事务响应延迟，二者之间存在典型的非线性关系。
- 吞吐量（Throughput）：在水位较低时，增加并发连接可以线性提升吞吐；当水位超过70%后，吞吐增长趋缓；达到85%以上时，吞吐可能不升反降（因上下文切换与锁竞争加剧）。
- 延迟（Latency）：水位低于50%时，延迟基本稳定；水位在50%~80%区间，延迟缓慢上升；水位超过80%后，延迟呈指数级增长，尤其是P99延迟。
3.4 水位与Saga事务的关联
在Saga编排场景中，连接池水位的影响会被放大。一个Saga事务可能包含多个本地事务（参与者），每个参与者都需要从连接池获取连接。水位过高时，Saga的补偿操作也可能因获取不到连接而失败，导致事务悬挂。
- 长链Saga：参与者数量多，连接占用时间长，水位上升更快。
- 补偿风暴：当Saga失败触发批量补偿时，短时间内大量补偿事务同时申请连接，水位可能瞬间冲高。
- 死锁风险：高水位下连接等待时间增加，Saga协调器与参与者之间可能形成资源死锁。
3.5 水位巡检的关键指标
在实际巡检中，除了水位百分比，还需要关注以下配套指标，才能准确判断连接池健康状态：
| 指标名称 | 正常范围 | 异常表现 | 与水位的关系 |
|---|---|---|---|
| 连接获取等待时间 | < 10ms | > 50ms 持续上升 | 水位越高，等待时间越长 |
| 连接获取超时率 | 0% | > 0.1% | 水位超过90%时超时率急剧上升 |
| 活跃连接数 | ≤ maxTotal × 70% | 接近 maxTotal | 活跃连接数直接决定水位 |
| 空闲连接数 | ≥ maxTotal × 10% | 接近0 | 空闲连接不足时水位易冲高 |
| 连接创建速率 | 稳定，无突发 | 频繁创建/销毁 | 水位波动大时创建速率异常 |
巡检最佳实践： 建议将水位监控与Saga事务的
补偿触发率 和 事务完成时间 关联分析。当水位超过80%且补偿触发率同步上升时，说明连接池已成为Saga编排的瓶颈，需要优先调优连接池参数或调整Saga的并发控制策略。