📚 课程目录第1章连接池基础

1. 连接池基础：定义、作用与核心参数

连接池是数据库访问层中最基础也最关键的组件。在分布式系统中，每一次数据库操作都需要建立 TCP 连接、完成握手认证、分配服务端资源，这一过程通常耗时 10–100ms。如果每次请求都重复创建和销毁连接，系统吞吐量将急剧下降。连接池的核心思想是：复用已建立的连接，避免频繁创建和销毁的开销。

1.1 连接池的定义与作用

维度	说明
定义	连接池是一个维护数据库连接对象的缓存池，应用启动时预先创建一定数量的连接，请求到来时从池中获取，使用完毕后归还，而非关闭。
核心作用	降低连接创建/销毁开销、控制并发连接数上限、防止数据库被突发流量打满、提供连接超时与健康检测机制。
适用场景	高并发 Web 服务、微服务架构、批处理任务、Outbox 模式中的事务性消息发送。

  故障排查视角： 连接池水位异常（连接数过高或过低）是 Outbox 模式中常见的故障根因。理解连接池参数，是定位“数据库连接耗尽”或“事务超时”的第一步。

1.2 连接池核心参数详解

连接池的行为由一组参数控制。以下四个参数是配置和排查的焦点：

参数	默认值（常见）	含义	设置建议
最小连接数	5–10	连接池中始终保持的闲置连接数量，用于应对突发流量。	根据业务基线设置，避免频繁创建新连接。
最大连接数	20–100	连接池允许同时存在的最大连接数，超过此数的新请求将等待或失败。	不超过数据库 max_connections 的 80%。
超时时间	30s	连接闲置超过此时间后，连接池会将其关闭并回收。	根据业务空闲间隔设置，避免连接泄漏。
最大等待时间	5s	请求从连接池获取连接时，最多等待的时间；超时则抛出异常。	结合业务 RT 容忍度设置，避免请求长时间阻塞。

常见误区： 最大连接数设置过大（如 500）会导致数据库端连接数被打满，引发“too many connections”错误；设置过小则导致请求排队超时。最小连接数设置过高会浪费数据库资源，设置过低则在高并发时频繁创建连接，增加延迟。

1.3 连接池工作流程

下图展示了连接池从初始化到请求获取、归还、回收的完整生命周期：

1.4 连接池参数配置示例

以 Java 生态中最常用的 HikariCP 为例，一个典型的连接池配置如下：

# HikariCP 连接池配置示例
spring.datasource.hikari.minimum-idle=10
spring.datasource.hikari.maximum-pool-size=50
spring.datasource.hikari.idle-timeout=30000
spring.datasource.hikari.connection-timeout=5000
spring.datasource.hikari.max-lifetime=1800000
spring.datasource.hikari.connection-test-query=SELECT 1

参数关联性： max-lifetime（连接最大存活时间）应小于数据库端的 wait_timeout，避免连接被数据库强制断开后仍被应用使用。建议 max-lifetime 设置为 30 分钟，idle-timeout 设置为 30 秒。

1.5 连接池水位与故障的关系

在 Outbox 模式中，事务性消息发送需要占用数据库连接。当连接池水位异常时，典型表现如下：

水位过高（连接数接近最大值）：新请求等待连接超时，业务响应变慢，甚至触发熔断。
水位过低（闲置连接不足）：高并发时频繁创建新连接，数据库负载飙升，连接建立耗时增加。
水位波动剧烈：连接数在短时间内从低到高再回落，通常由突发流量或慢查询导致。