3. 连接池核心概念：定义、池化思想与关键参数
在 PostgreSQL 中间件架构中，连接池是保障数据库高并发、低延迟的核心组件。本章从连接池的定义出发，深入剖析池化思想，并详细解读最小连接数、最大连接数、空闲连接超时等关键参数的设计原理与配置策略。
3.1 连接池的定义
连接池（Connection Pool）是一种预先创建并维护一组数据库连接的技术。应用程序不再直接向 PostgreSQL 发起 TCP 连接，而是从连接池中“借用”一个已就绪的连接，使用完毕后再“归还”给池，而非关闭连接。
核心价值：复用连接，避免频繁创建/销毁连接带来的 TCP 三次握手、认证握手、内存分配等开销。
| 对比维度 | 无连接池（直连） | 有连接池（中间件） |
|---|---|---|
| 连接建立耗时 | 每次请求 2~10ms（含 TCP + 认证） | 从池中获取 < 0.1ms |
| 数据库并发连接数 | 随请求数线性增长，易达上限 | 稳定在配置的最大值内 |
| 资源开销 | 每个连接占用约 5~10MB 内存 | 连接复用，内存开销可控 |
| 连接泄漏风险 | 高（连接未关闭即泄漏） | 低（池自动回收泄漏连接） |
3.2 池化思想
池化（Pooling）是一种通用的资源管理思想，核心原则是“复用”与“预分配”。在数据库中间件场景下，池化思想体现为以下三层设计：
- 预创建：中间件启动时，按最小连接数预先建立一批连接到 PostgreSQL。
- 借用/归还：应用请求到来时，从池中取出空闲连接；请求结束后，将连接状态重置并放回池中。
- 动态伸缩：根据负载压力，在最小连接数与最大连接数之间动态调整活跃连接数量。
池化思想延伸：连接池不仅管理 TCP 连接，还管理会话状态（如 prepared statement、事务隔离级别）。PgBouncer 的
transaction 模式即是在事务粒度上复用连接，进一步提升池化效率。
3.3 最小连接数（minPoolSize）
最小连接数指连接池在空闲状态下保持的最少连接数量。即使没有任何应用请求，池中也会维持这些连接处于就绪状态。
- 作用：消除冷启动延迟，应对突发流量。
- 推荐值：通常设置为
5~10，或根据应用平均并发数估算。 - 风险：设置过大，空闲时浪费数据库内存资源；设置过小，突发流量时仍需新建连接。
避坑提示：在 PgBouncer 中，
min_pool_size 仅在 transaction 模式下生效。如果使用 session 模式，最小连接数参数将被忽略。
3.4 最大连接数（maxPoolSize）
最大连接数限制连接池能够同时持有的最大连接数量。这是保护 PostgreSQL 不被连接风暴击穿的关键防线。
| 参数 | 说明 | 典型值 |
|---|---|---|
maxPoolSize |
池中最大连接数，超过此值的新请求将排队等待 | 50~200 |
max_connections（PG） |
PostgreSQL 实例允许的最大连接数 | 100~500 |
| 连接池与 PG 比例 | 建议 maxPoolSize ≤ PG max_connections × 0.8 | 留 20% 给管理连接 |
关键原则：最大连接数不是越大越好。PostgreSQL 每个连接都会消耗共享缓冲区、锁、进程槽等资源。过大的连接数会导致上下文切换加剧，反而降低吞吐量。
3.5 空闲连接超时（idleTimeout）
空闲连接超时定义了一个连接在池中保持空闲状态的最大时长。超过该时长，连接池将主动关闭该连接，释放数据库资源。
- 单位：通常为秒或毫秒。
- 典型值：
300s（5分钟）~1800s（30分钟）。 - 行为：当空闲连接数超过最小连接数时，超时的连接会被回收；池中连接数降至最小连接数后停止回收。
调优建议：如果应用存在周期性空闲（如夜间低负载），建议将空闲超时设置为
600s 左右，避免频繁重建连接。如果数据库连接数紧张，可缩短至 120s。
3.6 参数配置对比速查表
| 参数名称 | PgBouncer | Pgpool-II | 应用层连接池（HikariCP） |
|---|---|---|---|
| 最小连接数 | min_pool_size |
num_init_children |
minimumIdle |
| 最大连接数 | default_pool_size |
max_pool |
maximumPoolSize |
| 空闲超时 | server_idle_timeout |
connection_cache_time |
idleTimeout |
| 连接最大存活时间 | server_lifetime |
child_life_time |
maxLifetime |
实战要点：在配置连接池时，务必确保
maxPoolSize × 中间件节点数 ≤ PostgreSQL 的 max_connections × 0.8。例如：PG max_connections=200，部署 2 个 PgBouncer 节点，则每个节点 maxPoolSize 建议 ≤ 80。