4. 连接池核心参数：最大连接数、最小空闲连接、连接超时、空闲超时、最大生命周期

连接池的稳定性直接决定了 Kubernetes 集群中微服务的吞吐与故障恢复速度。五个核心参数——最大连接数、最小空闲连接、连接超时、空闲超时、最大生命周期——构成了连接池的“水位边界”与“回收策略”。理解每个参数的作用域与调优逻辑，是巡检水位的前提。

4.1 参数全景图

下表从语义、默认值、巡检关注点三个维度对齐五个核心参数：

4.2 参数交互与水位模型

五个参数并非独立工作，它们共同定义了连接池的“水位线”。下图展示了连接池从创建到回收的完整生命周期，以及每个参数的作用位置：

4.3 参数配置策略与巡检指标

不同业务场景下，五个参数的配置策略差异显著。下表给出典型场景的推荐值及巡检指标：

4.4 参数配置示例（HikariCP + Spring Boot）

以下是一个生产级 HikariCP 连接池配置，覆盖全部五个核心参数：

spring:
  datasource:
    hikari:
      # 最大连接数（包含活跃+空闲）
      maximum-pool-size: 30
      # 最小空闲连接数
      minimum-idle: 10
      # 获取连接超时时间（毫秒）
      connection-timeout: 5000
      # 空闲连接最大存活时间（毫秒）
      idle-timeout: 600000
      # 连接最大生命周期（毫秒）
      max-lifetime: 1800000
      # 连接池名称（便于监控）
      pool-name: "K8sHikariPool"

4.5 巡检水位的关键指标

在 Kubernetes 环境中，通过 Prometheus + Grafana 监控连接池水位时，重点关注以下指标：

• 活跃连接数 / 最大连接数：比值超过 80% 时触发告警，表示连接池接近饱和。
• 空闲连接数 / 最小空闲连接：持续低于最小值说明连接创建速度跟不上回收速度。
• 连接超时次数：单位时间内超时次数突增，通常意味着最大连接数不足或后端响应变慢。
• 连接创建速率：过高（>10/s）可能由空闲超时过短或最大生命周期过短导致。
• 连接泄漏检测：活跃连接数长期不下降，且无对应请求量，说明存在连接未归还。