1. 课程导论：连接池泄漏的定义、尾延迟压测波动的现象、课程目标与学习路径
1.1 连接池泄漏：定义与本质
连接池泄漏（Connection Pool Leak）是指应用程序在使用完数据库或远程服务连接后，未能正确将连接归还至连接池，导致池中可用连接数持续减少，最终耗尽池容量，引发新请求排队或失败的现象。在搜索服务中，连接池通常用于管理对后端索引库、缓存或外部特征服务的 TCP 长连接。
核心特征： 连接被“借出”后从未“归还”，池内可用连接数单调递减，直至触发
getConnection() 超时或拒绝连接异常。
| 维度 | 正常连接复用 | 连接池泄漏 |
|---|---|---|
| 连接生命周期 | 借出 → 使用 → 归还 → 复用 | 借出 → 使用 → 丢失引用 |
| 池内可用连接数 | 稳定在 minIdle ~ maxTotal 之间 |
持续下降，最终为 0 |
| 新请求行为 | 从池中快速获取，毫秒级响应 | 等待超时或创建新连接（若允许），响应劣化 |
| 典型根因 | — | 未关闭 ResultSet/Statement、异常路径未释放、连接池 evict 配置缺失 |
1.2 尾延迟压测波动：现象与关联
在压测场景下，连接池泄漏会引发一种特殊的尾延迟（Tail Latency）波动模式：长时间平稳 → 突然尖刺 → 短暂恢复 → 再次尖刺。这种波动与连接池的“耗尽—重建”周期高度耦合。
- 平稳期： 池中连接充足，P99 延迟稳定在基线（如 5ms）。
- 泄漏积累期： 可用连接逐渐减少，部分请求开始排队，P99 缓慢抬升（如 5ms → 20ms）。
- 耗尽尖刺期： 池中连接数为 0，新请求必须等待超时或创建新连接，P99 瞬间飙升至秒级（如 2000ms）。
- 恢复期： 部分连接被归还或新建连接入池，延迟回落，但泄漏仍在继续，周期重复。
实战观察： 在搜索服务的压测监控中，若发现 P99 延迟呈现“锯齿状”周期波动，且与连接池
activeCount 达到 maxTotal 的时间点重合，几乎可以锁定连接池泄漏问题。
1.3 课程目标
本课程旨在帮助 SRE 与后端开发人员系统性地掌握连接池泄漏的排查与缓解技术，具体目标如下：
- 理解原理： 深入连接池实现机制（Apache DBCP、HikariCP、Jedis Pool），掌握泄漏产生的底层原因。
- 精准定位： 学会使用
jstack、jmap、Arthas、连接池 JMX 监控、网络抓包等工具，在压测环境下快速定位泄漏代码路径。 - 缓解与修复： 掌握连接泄漏的临时缓解策略（动态扩容、evict 线程调优）与根本修复方法（资源关闭规范、异常处理重构）。
- 预防体系： 建立连接池健康度监控、压测准入门禁、代码审查清单等长效预防机制。
1.4 学习路径与课程地图
课程共 30 章，按“现象识别 → 原理剖析 → 工具实战 → 修复优化 → 体系化建设”五阶段组织：
| 阶段 | 章节范围 | 核心产出 |
|---|---|---|
| 阶段一：现象与诊断 | 第 1–6 章 | 尾延迟波动识别、连接池监控搭建、压测场景复现 |
| 阶段二：泄漏根因分析 | 第 7–14 章 | 线程栈分析、连接跟踪、代码路径定位 |
| 阶段三：缓解与修复 | 第 15–22 章 | 连接池参数调优、资源关闭重构、异常处理加固 |
| 阶段四：压测验证 | 第 23–26 章 | 压测脚本优化、延迟分布对比、回归门禁 |
| 阶段五：体系化建设 | 第 27–30 章 | 监控告警、代码规范、故障演练、团队 SOP |
前置要求： 建议学习者具备 Java 应用运维基础、熟悉 Linux 命令行、了解基本压测工具（如 wrk、JMeter 或自研压测平台）。课程中的代码示例以 Java 连接池为主，但排查方法论同样适用于 Go、Python 等语言的连接池实现。