1. 连接池基础：什么是数据库连接池、为什么需要连接池、连接池的核心指标

1.1 什么是数据库连接池

数据库连接池（Connection Pool）是一种在应用启动时预先创建并维护一组数据库连接的机制。这些连接被集中管理、复用，而不是每次请求都新建和销毁。在 Go 语言中，database/sql 标准库内置了连接池实现，开发者无需自行编写池化逻辑。

1.2 为什么需要连接池

每次新建数据库连接都涉及 TCP 三次握手、认证、资源分配等开销。无连接池时，每个请求都经历“创建 → 使用 → 销毁”的完整周期，在高并发场景下会引发严重性能问题。

1.3 连接池的核心指标

理解连接池的运行状态，需要掌握三个核心水位指标。它们共同决定了池的健康状况和吞吐能力。

1.3.1 活跃连接数（InUse / Active）

当前正在被 goroutine 持有、执行数据库操作的连接数量。活跃连接数过高通常意味着数据库负载大或查询慢，导致连接迟迟不归还。

1.3.2 空闲连接数（Idle）

已建立但未被使用的连接，处于待命状态。空闲连接可以快速响应突发请求，但过多空闲连接会浪费内存和数据库资源。

1.3.3 最大打开连接数（MaxOpenConns）

连接池允许打开的最大连接总数（活跃 + 空闲）。超过此限制的请求将阻塞等待，直到有连接被归还。

1.4 Go 中查看连接池状态

Go 的 database/sql 包提供了 DB.Stats() 方法，返回一个 DBStats 结构体，包含所有核心指标：

import (
    "database/sql"
    "fmt"
    "log"
)

func printPoolStats(db *sql.DB) {
    stats := db.Stats()
    fmt.Printf("=== 连接池状态 ===\n")
    fmt.Printf("最大打开连接数: %d\n", stats.MaxOpenConnections)
    fmt.Printf("活跃连接数:     %d\n", stats.InUse)
    fmt.Printf("空闲连接数:     %d\n", stats.Idle)
    fmt.Printf("等待获取连接数: %d\n", stats.WaitCount)
    fmt.Printf("等待总耗时:     %v\n", stats.WaitDuration)
    fmt.Printf("连接被关闭数:   %d\n", stats.MaxIdleClosed + stats.MaxLifetimeClosed)
}

1.5 连接池水位管理的核心原则

• 水位不宜过高：活跃连接数持续接近 MaxOpenConns 时，请求开始排队，延迟上升。此时应优先优化查询，而非盲目调大连接数。
• 水位不宜过低：空闲连接数长期为 0，突发流量到来时需等待建连，造成毛刺延迟。
• 监控先行：在生产环境定期采集 db.Stats() 数据，接入 Prometheus 等监控系统，设置告警规则。
• 结合业务场景调参：读多写少的服务可适当增加空闲连接；事务密集型服务需关注事务持有连接的时间。