1. 连接池基础概念

1.1 什么是连接池

连接池（Connection Pool）是一种在应用启动时预先创建并维护一组数据库连接的资源管理技术。这些连接被集中存放在一个“池”中，当应用程序需要与数据库交互时，不再执行完整的 TCP 握手、认证和会话建立流程，而是直接从池中获取一个已就绪的连接；使用完毕后，连接归还至池中，而非真正关闭。

1.2 为什么需要连接池

在 Go Web 服务中，每次数据库操作都经历“建立连接 → 执行查询 → 关闭连接”的完整生命周期，会产生显著的性能瓶颈。连接池通过复用机制解决了以下核心问题：

1.3 连接池的核心参数

Go 的 database/sql 包通过 sql.DB 对象管理连接池，提供三个关键配置参数。合理设置这些参数是连接池性能优化的基础。

1.3.1 最大连接数（MaxOpenConns）

连接池允许打开的最大数据库连接数量，包括活跃连接和空闲连接。当所有连接都在使用中时，新的数据库请求将阻塞等待，直到有连接被归还或超时。

// Go 示例：设置最大连接数
db, err := sql.Open("mysql", dsn)
if err != nil {
    log.Fatal(err)
}

// 设置最大打开连接数为 100
db.SetMaxOpenConns(100)

1.3.2 最小空闲连接数（MaxIdleConns）

连接池中保持的空闲连接数量。这些连接已建立但未被使用，随时可以响应新请求。适当设置空闲连接数可以避免流量突发时的连接建立延迟。

// 设置最大空闲连接数为 25
db.SetMaxIdleConns(25)

1.3.3 连接超时（ConnMaxLifetime / ConnMaxIdleTime）

连接超时参数控制连接的生命周期，防止使用过期或异常连接：

• ConnMaxLifetime：连接的最大存活时间。超过此时间的连接将被强制关闭并重建，防止数据库端（如 MySQL wait_timeout）主动断开导致连接失效。
• ConnMaxIdleTime：连接的最大空闲时间。超过此时间未使用的空闲连接将被关闭，释放数据库资源。

// 设置连接最大存活时间为 30 分钟
db.SetConnMaxLifetime(30 * time.Minute)

// 设置连接最大空闲时间为 5 分钟
db.SetConnMaxIdleTime(5 * time.Minute)

1.4 连接池的工作流程

Go 的 database/sql 连接池遵循以下生命周期：

1. 初始化：调用 sql.Open() 时创建连接池，但不会立即建立连接。连接在第一次查询时按需创建。
2. 获取连接：当 Goroutine 发起数据库操作时，优先从空闲队列获取连接；若无空闲连接且未达到最大连接数，则新建连接；若已达最大连接数，则阻塞等待。
3. 使用连接：Goroutine 持有连接执行 SQL 查询或事务。
4. 归还连接：操作完成后，连接被归还至空闲队列，供其他 Goroutine 复用。
5. 健康检查：在获取连接时，Go 会检查连接是否有效（通过 Ping 或预检查询），无效连接会被丢弃并重建。
6. 过期回收：后台 Goroutine 定期检查连接的生命周期和空闲时间，超过阈值的连接被关闭。