2、Go database/sql 包基础：核心接口（DB、Conn、Stmt、Tx）介绍，连接池的默认行为

在深入排查连接池配置导致的慢查询之前，必须理解 Go 标准库 database/sql 包的核心抽象。该包通过四个关键接口——DB、Conn、Stmt、Tx——屏蔽了底层数据库驱动的差异，并内置了一个自动管理的连接池。本章将逐一拆解这些接口的职责与协作方式，并揭示连接池的默认行为，为后续调优打下基础。

2.1 核心接口概览

下表总结了四个核心接口的职责、生命周期与典型使用场景：

2.2 DB 对象：连接池的入口

sql.Open 返回的 *sql.DB 并非一个真实的网络连接，而是一个连接池管理器。它负责创建、复用、保活和关闭底层连接。其核心行为包括：

• 惰性初始化：调用 Open 时不会立即建立连接，首次实际查询或执行时才会创建。
• 线程安全：多个 goroutine 可安全共享同一个 *sql.DB 实例。
• 连接池参数：通过 SetMaxOpenConns、SetMaxIdleConns、SetConnMaxLifetime 控制池行为。

2.3 Conn：直接操作底层连接

当需要执行数据库会话级操作（如设置 SET NAMES utf8mb4、临时表、锁表）时，可通过 DB.Conn(ctx) 获取一个独占的 *sql.Conn。使用完毕后必须调用 Close 归还给池，否则会导致连接泄漏。

// 获取独占连接
conn, err := db.Conn(ctx)
if err != nil {
    log.Fatal(err)
}
defer conn.Close() // 必须归还

// 执行会话级操作
conn.ExecContext(ctx, "SET SESSION wait_timeout = 10")

2.4 Stmt：预编译语句复用

预编译语句（Prepared Statement）将 SQL 解析与执行计划缓存到数据库端，避免重复解析开销。database/sql 提供两种创建方式：

• DB.Prepare：从池中获取连接进行预编译，后续执行时自动选择池中任意连接。
• Tx.Stmt：将已有 Stmt 绑定到当前事务的连接上，保证事务内一致性。

// 从 DB 预编译
stmt, err := db.Prepare("SELECT name FROM users WHERE id = ?")
if err != nil {
    log.Fatal(err)
}
defer stmt.Close()

// 多次执行
var name string
stmt.QueryRow(1).Scan(&name)
stmt.QueryRow(2).Scan(&name)

2.5 Tx：事务的边界管理

事务通过 DB.BeginTx 启动，返回 *sql.Tx。事务期间所有操作绑定到同一个底层连接，直到 Commit 或 Rollback 后连接才归还池中。

tx, err := db.BeginTx(ctx, &sql.TxOptions{Isolation: sql.LevelSerializable})
if err != nil {
    return err
}
defer tx.Rollback() // 确保未提交时回滚

_, err = tx.ExecContext(ctx, "UPDATE accounts SET balance = balance - 100 WHERE id = 1")
if err != nil {
    return err
}
_, err = tx.ExecContext(ctx, "UPDATE accounts SET balance = balance + 100 WHERE id = 2")
if err != nil {
    return err
}
return tx.Commit()

2.6 连接池默认行为

Go 1.0 起，database/sql 的连接池默认参数如下：

2.7 核心接口协作流程

下图展示了 DB、Conn、Stmt、Tx 与底层连接池之间的协作关系：

2.8 默认行为下的典型问题场景

理解默认行为后，可以预见以下常见故障模式：

• 连接数耗尽：MaxOpenConns 为 0 时，突发流量可能创建数千个连接，导致数据库端拒绝服务。
• 空闲连接不足：默认仅 2 个空闲连接，高并发下每个新请求都要创建新连接，增加延迟。
• 连接过期：ConnMaxLifetime 为 0 时，连接可能被数据库或中间件（如 MySQL wait_timeout）静默关闭，应用使用已失效连接报错。
• 事务阻塞：长事务占用连接不释放，池中无空闲连接时，其他查询排队等待，形成慢查询假象。