3. 连接池核心概念

连接池是网关水位管理的核心基础设施。在 Go 权限审计网关中，每一次用户请求都可能涉及与后端认证服务、审计日志服务、数据库或缓存系统的网络交互。如果每次请求都新建和销毁连接，系统将面临巨大的资源开销和延迟抖动。连接池通过复用已建立的连接，显著降低延迟、减少系统资源消耗，并为水位控制提供可观测的度量基础。

3.1 连接池的定义与核心价值

连接池（Connection Pool）是一种预先创建并维护一组网络连接的技术。应用程序从池中“借出”连接，使用完毕后“归还”到池中，而非直接关闭。其核心价值体现在以下三个方面：

3.2 连接池的生命周期

一个标准的连接池生命周期包含以下五个阶段，每个阶段都对应着水位管理的关键决策点：

1. 初始化（Init）：根据配置创建核心连接数（core）和最大连接数（max），预创建部分连接放入空闲队列。
2. 借用（Borrow）：调用方从池中获取连接。若空闲队列有可用连接则直接返回；否则根据水位策略决定等待或新建。
3. 使用（Use）：调用方执行业务逻辑（如发送 SQL 查询、发起 HTTP 请求）。此阶段连接处于“活跃”状态。
4. 归还（Return）：使用完毕后将连接归还池中。归还时需检查连接健康状态（如心跳检测），异常连接将被销毁。
5. 销毁（Destroy）：当连接空闲超时、健康检查失败或池缩容时，关闭连接并释放资源。

3.3 复用机制与健康保障

连接复用并非简单的“借还”操作，它需要一套完整的机制来保证复用连接的正确性和安全性：

• 空闲复用：连接归还后进入空闲队列，后续请求优先复用。Go 的 database/sql 包和 net/http 的 Transport 均采用此模式。
• 健康检查：归还时或借用前执行心跳检测（如 TCP Keep-Alive、应用层 Ping），失效连接自动剔除。
• 自动扩容/缩容：当空闲连接耗尽且未达到最大连接数时，创建新连接；当空闲连接超过核心数且持续空闲超时时，逐步关闭多余连接。
• 连接保活：定期发送心跳包防止中间设备（如防火墙、NAT 网关）回收空闲连接。

// Go 标准库连接池复用示例（database/sql）
db, _ := sql.Open("mysql", "user:pass@tcp(127.0.0.1:3306)/db")
db.SetMaxOpenConns(100)   // 最大打开连接数
db.SetMaxIdleConns(20)    // 最大空闲连接数
db.SetConnMaxLifetime(5 * time.Minute) // 连接最大存活时间

// 连接复用：多次查询共享池中连接
for i := 0; i < 1000; i++ {
    go func() {
        rows, _ := db.Query("SELECT id FROM users LIMIT 1")
        rows.Close() // 归还连接到池中
    }()
}

3.4 常见连接池类型

在 Go 权限审计网关中，主要涉及以下三种连接池类型，它们的水位管理策略各有侧重：

3.5 连接池水位管理的核心指标

为有效管理连接池水位，必须持续观测以下四个关键指标。这些指标将作为后续章节中水位算法和动态调整策略的输入：

• Active（活跃连接数）：当前正在被使用的连接数量。反映系统实时负载。
• Idle（空闲连接数）：池中可用但未被使用的连接数量。反映缓冲能力。
• WaitCount（等待请求数）：因无可用连接而阻塞的请求数量。反映拥塞程度。
• WaitDuration（等待时长）：请求等待获取连接的平均耗时。反映性能瓶颈。