2. Go database/sql 标准库概览：核心接口与连接池默认行为

在深入慢查询调优之前，必须理解 Go 标准库 database/sql 的核心抽象层。该库并非数据库驱动，而是一个通用 SQL 接口，定义了 DB、Stmt、Tx、Rows 四大核心接口，并内置了一个连接池（Connection Pool）。连接池的默认行为直接影响查询性能与资源复用效率。

2.1 四大核心接口

2.2 连接池的默认行为

连接池由 sql.DB 内部维护，默认行为如下：

• 无限制最大连接数： 默认 SetMaxOpenConns(0)，表示不限制打开连接数，可能导致数据库资源耗尽。
• 无限制空闲连接数： 默认 SetMaxIdleConns(0)，但实际实现中默认保留 2 个空闲连接（Go 1.x 行为）。
• 连接无限复用： 空闲连接不会自动关闭，除非显式设置 SetConnMaxLifetime 或 SetConnMaxIdleTime。
• 连接获取策略： 优先从空闲队列获取；若无空闲且未达上限，则新建连接；若已达上限，则阻塞等待其他 goroutine 释放。

2.3 连接池核心参数

2.4 连接池工作流程

2.5 连接复用与慢查询的关系

连接池的复用策略直接影响查询延迟：

• 连接建立开销： 每次新建连接需要 TCP 握手、TLS 协商、认证鉴权，耗时 10~100ms。复用空闲连接可消除此开销。
• 连接泄漏： 如果 Rows 或 Stmt 未正确关闭，连接无法归还池中，导致池中可用连接减少，后续请求阻塞等待。
• 连接老化： 长时间复用的连接可能被数据库端断开，下次查询时返回“连接已关闭”错误，触发重连，增加延迟。
• 连接数上限： 若 MaxOpenConns 设置过小，高并发时请求排队，产生“连接等待”延迟；设置过大则数据库负载飙升。

2.6 典型代码模式

// 初始化连接池
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(50)           // 最大空闲连接数
db.SetConnMaxLifetime(30 * time.Minute)  // 连接最大存活时间
db.SetConnMaxIdleTime(5 * time.Minute)   // 空闲连接最大存活时间

// 验证连接有效性
if err := db.Ping(); err != nil {
    log.Fatal("数据库连接失败:", err)
}

// 查询示例
rows, err := db.Query("SELECT id, name FROM users WHERE status = ?", 1)
if err != nil {
    log.Fatal(err)
}
defer rows.Close()  // 必须关闭，否则连接泄漏

for rows.Next() {
    var id int
    var name string
    if err := rows.Scan(&id, &name); err != nil {
        log.Fatal(err)
    }
    // 处理结果
}
if err := rows.Err(); err != nil {
    log.Fatal(err)
}