1. 连接池基础概念

1.1 什么是连接池

连接池（Connection Pool）是一种在应用启动时预先创建并维护一组数据库或服务连接的资源管理技术。在 Docker 容器化环境中，连接池通常位于应用进程内部，作为中间件层管理对后端服务（如 MySQL、Redis、gRPC 服务）的 TCP 连接。

1.2 为什么需要连接池

在 Docker 容器内，每次创建新连接的开销尤为突出。连接池通过复用已建立的连接，显著降低延迟和资源消耗。

1.3 连接池的核心参数

正确配置连接池参数是性能调优的基础。以下四个参数是所有连接池实现（HikariCP、Druid、JedisPool、gRPC 连接池等）共有的核心控制点。

1.3.1 最小连接数（Minimum Idle / Core Pool Size）

连接池在空闲状态下保持的最小连接数量。这些连接预先建立并处于就绪状态，随时可供业务线程使用。

• 作用：应对突发流量，避免流量尖峰时因创建新连接而增加延迟。
• 设置建议：通常设置为应用日常并发量的 30%~50%。
• Docker 环境注意：容器内存受限，最小连接数不宜过大，否则会浪费宝贵的内存资源。

1.3.2 最大连接数（Maximum Pool Size）

连接池允许同时存在的最大连接数量，包括活跃连接和空闲连接。

• 作用：保护后端服务不被过多连接压垮，同时限制容器自身的 socket 资源消耗。
• 设置建议：根据后端服务的最大连接上限和容器 CPU 核心数综合计算。经验公式：最大连接数 = (CPU核心数 × 2) + 有效磁盘数（适用于 IO 密集型场景）。
• Docker 环境注意：容器 CPU 限制（--cpus）会直接影响最佳最大连接数，超配会导致线程争抢。

1.3.3 超时时间（Connection Timeout / Connect Timeout）

从连接池获取连接时，等待连接可用的最大时间。如果超过此时间仍未获取到连接，则抛出异常。

• 作用：防止业务线程无限等待，保障系统可用性。
• 设置建议：通常设置为 500ms~3000ms。过短会导致频繁超时，过长会拖慢故障恢复。
• Docker 环境注意：容器网络延迟可能略高于宿主机，建议适当放宽 20%~50%。

1.3.4 最大等待时间（Max Lifetime / Idle Timeout）

连接在池中保持空闲状态的最大时间，超过此时间连接将被关闭并从池中移除。

• 作用：回收长时间不用的连接，释放服务端和容器资源。
• 设置建议：通常设置为 30 秒~10 分钟，取决于后端服务的连接空闲超时策略。
• Docker 环境注意：容器网络环境中的 NAT 或负载均衡器可能强制断开空闲连接，建议设置比后端超时时间短 10~20 秒。

1.4 参数配置速查表