3、事务与连接的关系：事务如何从连接池获取连接、事务生命周期、连接泄漏场景

事务与连接是数据库中间件中耦合最紧密的一对概念。连接池管理的是物理或逻辑连接的生命周期，而事务则是在连接之上划定的一组原子操作边界。理解二者如何绑定、如何流转、以及如何因错误使用导致连接泄漏，是掌握水位接口契约的前提。

3.1 事务获取连接的两种模式

在 Go 的 database/sql 标准库中，事务并非独立于连接存在。事务本质上是对一个连接的“独占式借用”。获取事务时，连接池必须从空闲队列或活跃池中分配一个连接，并将该连接标记为“事务中”状态。

3.2 事务生命周期：从借用到归还的完整路径

一个事务从创建到销毁，经历以下五个阶段。每个阶段都与连接池的水位状态直接相关。

1. 申请阶段： 调用 Begin 或 conn.BeginTx，连接池从空闲链表中取出一个连接，将其状态标记为 inTx=true，活跃连接数 +1。
2. 执行阶段： 事务内的所有 Query/Exec 操作复用同一连接，连接池不再将该连接分配给其他请求。
3. 提交/回滚阶段： 调用 Commit 或 Rollback，驱动层发送结束事务命令，连接状态清除 inTx 标记。
4. 归还阶段： 连接被放回空闲队列，活跃连接数 -1。若连接因网络错误或超时失效，则直接关闭并从池中移除。
5. 清理阶段（异常路径）： 如果事务未正常结束（如 panic、忘记调用 Commit/Rollback），连接将一直处于“借用中”状态，直到 Go 的 finalizer 或超时机制介入。

3.3 连接泄漏场景：事务未正确关闭的三种典型模式

连接泄漏是事务管理中最常见、最隐蔽的故障。泄漏的本质是：连接被事务借用后，从未归还给连接池。以下三种场景在 Go 生产环境中反复出现。

3.4 事务与连接绑定的核心流程图

下图展示了从连接池视角观察的事务获取、执行、归还全过程，以及泄漏点所在位置。

3.5 安全使用事务的防御性编码模式

为避免连接泄漏，Go 社区形成了以下标准防御模式。该模式的核心是：无论事务执行成功还是失败，都必须确保 Rollback 或 Commit 被调用且仅调用一次。

// 推荐的事务安全模式
func executeTransaction(ctx context.Context, db *sql.DB) error {
    tx, err := db.BeginTx(ctx, nil)
    if err != nil {
        return err
    }

    // 使用 defer 确保事务最终回滚（如果未提交）
    rolledBack := false
    defer func() {
        if !rolledBack {
            tx.Rollback() // 如果已提交，Rollback 是空操作
        }
    }()

    // 执行事务内操作
    if _, err := tx.ExecContext(ctx, "UPDATE accounts SET balance = balance - 100 WHERE id = 1"); err != nil {
        return err // defer 会触发 Rollback
    }

    if _, err := tx.ExecContext(ctx, "UPDATE accounts SET balance = balance + 100 WHERE id = 2"); err != nil {
        return err // defer 会触发 Rollback
    }

    // 提交事务
    if err := tx.Commit(); err != nil {
        return err // defer 会触发 Rollback（已提交的 Rollback 无副作用）
    }

    rolledBack = true // 标记已正常结束，避免 defer 重复 Rollback
    return nil
}

3.6 事务超时与连接池水位的联动

即使代码正确，长事务仍可能因执行时间过长而阻塞连接池。Go 1.13+ 提供了 BeginTx 的上下文超时机制，从源头控制事务生命周期。

3.7 事务连接泄漏的监控指标

在 Go 的 database/sql 包中，DB.Stats() 提供了直接反映事务与连接关系的指标。以下三个指标是水位接口契约的核心监控项。

• InUse：当前正在被使用的连接数（包括事务中和非事务查询）。如果该值长时间接近 MaxOpenConns，说明连接池接近满水位。
• Idle：空闲连接数。如果 Idle 持续为 0 且 InUse 未达上限，说明连接被事务长时间占用，存在泄漏风险。
• WaitCount：等待获取连接的请求总数。如果 WaitCount 持续增长，说明连接池已无可用连接，事务泄漏或长事务阻塞已发生。