事务开启与提交：Begin()、Commit() 与自动/手动提交

事务的生命周期始于 Begin()，终于 Commit() 或 Rollback()。在 Go API 中，如何开启、提交事务，以及选择自动提交还是手动提交，直接决定了数据一致性的边界和系统吞吐量。本章将深入剖析这三个核心操作，并通过对比表格和流程图帮助您建立清晰的事务边界认知。

1. Begin()：事务的起点

Begin() 方法从数据库连接池中获取一个连接，并将该连接的自动提交模式关闭，从而开启一个显式事务。在 Go 标准库 database/sql 中，调用 DB.Begin() 会返回一个 *Tx 对象，后续所有数据库操作（查询、更新、删除）都必须通过这个 Tx 对象执行，直到调用 Commit() 或 Rollback()。

// 标准 Go 事务开启模式
func CreateOrder(db *sql.DB, order Order) error {
    tx, err := db.Begin() // 开启事务
    if err != nil {
        return err
    }
    // 后续所有操作使用 tx 而非 db
    _, err = tx.ExecContext(ctx, "INSERT INTO orders ...", ...)
    if err != nil {
        tx.Rollback() // 失败时回滚
        return err
    }
    return tx.Commit() // 成功时提交
}

2. Commit()：事务的终点

Commit() 方法将事务期间所有未提交的更改持久化到数据库。调用 Commit() 后，*Tx 对象将失效，不能再用于任何数据库操作。如果 Commit() 失败（例如网络中断、数据库宕机），事务可能已经部分提交或完全未提交，此时需要根据错误类型决定是否重试或人工介入。

3. 自动提交与手动提交的核心区别

自动提交是数据库连接的默认行为：每条 SQL 语句都被视为一个独立的事务，执行后自动提交。手动提交则通过显式调用 Begin() 和 Commit() 将多条 SQL 语句组合成一个原子操作单元。下表从多个维度对比两者的差异：

4. 事务边界流程图

下面的 SVG 图展示了从连接池获取连接到最终提交或回滚的完整事务生命周期，清晰标出自动提交与手动提交的分岔路径：

5. 自动提交与手动提交的选型策略

在实际 Go API 开发中，选择自动提交还是手动提交需要根据业务场景权衡。以下是一份快速决策清单：

• 只读查询：优先使用自动提交，避免不必要的 Begin/Commit 开销。
• 单表单行更新：如果更新条件简单且无关联约束，自动提交足够。
• 多表关联更新：必须使用手动提交，确保数据一致性。
• 批量插入：手动提交 + 批量 SQL 可大幅提升性能，但需注意事务大小。
• 长时间持有事务：避免手动提交事务中夹杂 HTTP 调用或文件 I/O，防止锁竞争。

6. 代码示例：手动提交的正确模式

func TransferFunds(db *sql.DB, fromID, toID int64, amount float64) error {
    tx, err := db.Begin()
    if err != nil {
        return fmt.Errorf("begin tx: %w", err)
    }
    // 延迟回滚：如果 Commit 成功，Rollback 无副作用
    defer tx.Rollback()

    // 扣减转出账户
    _, err = tx.ExecContext(ctx,
        "UPDATE accounts SET balance = balance - $1 WHERE id = $2 AND balance >= $1",
        amount, fromID)
    if err != nil {
        return fmt.Errorf("debit: %w", err)
    }

    // 增加转入账户
    _, err = tx.ExecContext(ctx,
        "UPDATE accounts SET balance = balance + $1 WHERE id = $2",
        amount, toID)
    if err != nil {
        return fmt.Errorf("credit: %w", err)
    }

    // 显式提交
    if err = tx.Commit(); err != nil {
        return fmt.Errorf("commit tx: %w", err)
    }
    return nil
}

7. 自动提交与手动提交的底层对比图

下面的 SVG 图从数据库连接和网络交互的视角，对比自动提交与手动提交在底层的行为差异：

8. 常见陷阱与避坑指南