3. 连接池核心参数：最大连接数、最小空闲连接、连接超时、空闲超时

连接池是数据库、Redis、gRPC 等后端组件与 Kubernetes 工作负载之间的流量“水库”。四个核心参数直接决定了水位的涨落节奏和调优方向：最大连接数（水库容量）、最小空闲连接（死水位）、连接超时（取水等待上限）、空闲超时（蒸发速率）。

3.1 参数定义与作用域

3.2 参数联动与水位模型

下图展示了连接池在 Kubernetes Pod 实例中的水位变化逻辑。当请求突发时，连接数从 minIdle 向 maxConnections 爬升；空闲时段，idleTimeout 触发回收，水位回落至 minIdle 附近。

3.3 参数调优策略与 Kubernetes 适配

3.3.1 最大连接数（maxConnections）

• 下限公式： maxConnections ≥ 预期峰值 QPS × P99 响应时间（秒）。例如 QPS=2000、P99=50ms，则至少需要 100 个连接。
• 上限约束： 后端服务（如 PostgreSQL max_connections、Redis maxclients）的 70%~80%，预留缓冲。
• Kubernetes 适配： 每个 Pod 独立连接池，maxConnections = 后端上限 ÷ 预期 Pod 副本数。例如后端上限 200，Pod 副本 4，则每个 Pod 设为 45~50。

3.3.2 最小空闲连接（minIdle）

• 保活作用： 避免流量突发时因建连延迟导致请求排队。建议设为 maxConnections × 10%~20%。
• 冷启动优化： 在 Kubernetes 中，结合 startupProbe 预热连接池，使 Pod 就绪前已完成 minIdle 连接建立。
• 注意： 设置过高会导致空闲连接占用后端资源，尤其在多 Pod 场景下放大压力。

3.3.3 连接超时（connectTimeout）

• 典型值： 200ms~3s。内网服务建议 500ms~1s，跨可用区或公网可放宽至 3s。
• 与 Kubernetes 网络的关系： Service IPVS 转发、CNI 网络策略、DNS 解析都可能增加建连延迟。建议 connectTimeout 略大于集群内网络 P99 延迟。
• 快速失败： 超时后立即返回错误，避免线程/协程阻塞堆积，触发 maxConnections 保护。

3.3.4 空闲超时（idleTimeout）

• 典型值： 30s~300s。短连接场景（如 HTTP 请求）建议 30~60s；长连接场景（如 gRPC Stream）建议 120~300s。
• 回收机制： 连接池后台线程周期性扫描空闲连接，超过 idleTimeout 则关闭。回收过快会导致频繁建连，回收过慢会占用后端连接槽位。
• Kubernetes 特殊场景： 当 Pod 滚动更新或缩容时，idleTimeout 应小于 terminationGracePeriodSeconds，确保连接在 Pod 停止前被优雅关闭。

3.4 参数配置示例（Java HikariCP + Go sql.DB）

// Java HikariCP 配置示例
HikariConfig config = new HikariConfig();
config.setMaximumPoolSize(50);        // maxConnections
config.setMinimumIdle(10);            // minIdle
config.setConnectionTimeout(1000);    // connectTimeout (ms)
config.setIdleTimeout(120000);        // idleTimeout (ms)
config.setMaxLifetime(300000);        // 建议 maxLifetime > idleTimeout

// Go database/sql 配置示例
db, _ := sql.Open("postgres", dsn)
db.SetMaxOpenConns(50)                // maxConnections
db.SetMaxIdleConns(10)                // minIdle
db.SetConnMaxLifetime(5 * time.Minute) // 对应 maxLifetime
// Go 标准库没有直接暴露 idleTimeout，通过 SetConnMaxIdleTime 控制
db.SetConnMaxIdleTime(2 * time.Minute) // idleTimeout

3.5 常见陷阱与避坑指南