1. 连接池基础概念

在构建高并发 Go 服务时，数据库连接的管理方式直接影响系统的吞吐量与稳定性。连接池（Connection Pool）正是为了解决“每次请求都创建和销毁连接”这一低效模式而生的核心组件。本节将系统讲解连接池的定义、必要性以及三个核心水位参数。

1.1 什么是连接池

连接池是一组预先创建并保持活跃的数据库连接的集合。应用程序不再直接通过 net.Dial 或 sql.Open 每次新建 TCP 连接，而是从池中“借”一个可用连接，使用完毕后再“还”回池中。Go 标准库 database/sql 内置了连接池实现，开发者只需配置参数即可获得池化能力。

1.2 为什么需要连接池

在没有连接池的场景下，每个请求都经历“创建连接 → 执行 SQL → 关闭连接”的完整生命周期。对于高并发服务，这种模式会带来三个严重问题：

1.3 连接池的核心参数

Go 的 database/sql 包通过 sql.DB 对象暴露三个关键水位参数。理解并正确配置它们是连接池调优的起点。

1.3.1 最大连接数（MaxOpenConns）

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

• 设置过小：请求排队，吞吐受限。
• 设置过大：数据库负载过高，连接数超过数据库上限。
• 推荐起点：数据库 max_connections 的 80%，再根据压测调整。

1.3.2 最小空闲连接数（MaxIdleConns）

池中保持的空闲连接数量下限。Go 会定期清理超出此数量的空闲连接，但会尽力维持至少这么多空闲连接。

• 作用：应对突发流量，避免流量尖峰时全部新建连接。
• 设置建议：通常设为预期并发峰值的 10%~20%。
• 注意：如果设为 0，则所有连接用完后立即关闭，退化为无池模式。

1.3.3 连接最大存活时间（ConnMaxLifetime）

一个连接从创建到被强制关闭的最大时长。超过此时间的连接会被标记为“过期”，下次归还时关闭并新建。

• 必要性：防止数据库侧（如 MySQL wait_timeout）主动断开连接后，Go 侧仍使用“僵尸连接”。
• 典型值：5~30 分钟，取决于数据库超时配置。
• 关联参数：ConnMaxIdleTime 控制空闲连接的最大空闲时长。

1.4 参数配置示例

以下是一个 Go 中配置连接池参数的典型代码片段：

// 创建数据库连接池
db, err := sql.Open("mysql", "user:pass@tcp(127.0.0.1:3306)/dbname")
if err != nil {
    log.Fatal(err)
}

// 核心水位参数配置
db.SetMaxOpenConns(100)                // 最大连接数
db.SetMaxIdleConns(20)                 // 最小空闲连接数
db.SetConnMaxLifetime(30 * time.Minute) // 连接最大存活时间
db.SetConnMaxIdleTime(5 * time.Minute)  // 空闲连接最大空闲时间

1.5 参数对比速查表