1. 连接池基础概念

1.1 什么是连接池

连接池（Connection Pool）是一种在应用启动时预先创建并维护一组数据库连接的资源管理技术。这些连接被集中存放在一个“池”中，当应用程序需要访问数据库时，从池中获取一个空闲连接；使用完毕后，将连接归还到池中，而不是直接关闭。连接池的核心思想是“复用”，避免频繁创建和销毁连接带来的性能开销。

1.2 为什么需要连接池

在 Go 语言的高并发报表回放场景中，每次请求都创建新数据库连接会带来严重的性能问题。以下是连接池解决的核心痛点：

1.3 连接池的核心参数

Go 的 database/sql 包通过 sql.DB 对象暴露三个关键配置参数，它们直接决定了连接池的水位行为。理解这些参数是调优的基础。

1.3.1 最大连接数（MaxOpenConns）

池中允许打开的最大数据库连接总数，包括空闲连接和活跃连接。当所有连接都被占用时，新的请求会进入等待队列。

• 设置过小：请求排队严重，吞吐量受限，报表回放延迟增加。
• 设置过大：数据库连接数超载，导致数据库 CPU/内存飙升，甚至触发 OOM。
• 推荐策略：根据数据库规格和业务 QPS 估算，通常设置为 数据库 max_connections × 0.8 / 应用实例数。

1.3.2 最小空闲连接数（MaxIdleConns）

池中保持的最小空闲连接数量。即使没有请求，池也会维持至少这么多连接处于可用状态。

• 设置过小：突发流量时需新建连接，导致首次请求延迟增加。
• 设置过大：空闲连接占用数据库资源，造成浪费。
• 推荐策略：设置为预估的并发峰值 × 0.2~0.3，通常 10~50 之间。

1.3.3 最大等待时间（ConnMaxLifetime / ConnMaxIdleTime）

连接的最大存活时间和最大空闲时间。超过存活时间的连接会被关闭并重建，防止连接泄漏或数据库侧断开。

• ConnMaxLifetime：连接从创建到被强制关闭的最大时长，通常设置为 30 分钟~1 小时。
• ConnMaxIdleTime：连接空闲超过此时间将被关闭，通常设置为 5~10 分钟。
• 注意：如果数据库侧有连接超时（如 MySQL wait_timeout），ConnMaxLifetime 应小于该值。

1.4 参数配置示例

以下是一个 Go 报表回放场景的典型连接池配置：

import (
    "database/sql"
    "time"
    _ "github.com/go-sql-driver/mysql"
)

func InitDB() *sql.DB {
    dsn := "user:password@tcp(127.0.0.1:3306)/report_db?charset=utf8mb4"
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        panic(err)
    }

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

    // 验证连接池是否正常
    if err = db.Ping(); err != nil {
        panic(err)
    }
    return db
}

1.5 参数对比速查表