登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go database/sql TxOptions 的 ReadOnly 和 Isolation 怎么配合

来源:17golang原创

时间:2026-11-19 08:53:17 443浏览 收藏

在 Go 的 database/sql 中,TxOptions 的两个字段解决的是不同问题:ReadOnly 表达“这个事务只读”的意图,Isolation 表达并发事务之间希望采用的隔离级别。它们可以同时传给 DB.BeginTx,但不等于“只要填了字段,所有数据库驱动都会无条件接受”。

最常见的报表事务可以这样写:

ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()

// ReadOnly 表达查询意图,Isolation 只在确实需要更强一致性时设置。
tx, err := db.BeginTx(ctx, &sql.TxOptions{
    ReadOnly:  true,
    Isolation: sql.LevelRepeatableRead,
})
if err != nil {
    // BeginTx 失败通常是驱动或数据库不接受该事务配置。
    return fmt.Errorf("begin read-only transaction: %w", err)
}
defer tx.Rollback() // 提交成功后再次 Rollback 只会得到事务已结束错误,可安全忽略。

// 查询、Scan 和业务判断都应使用同一个 tx。
if err := tx.QueryRowContext(ctx, "SELECT total FROM daily_sales WHERE day = ?", day).Scan(&total); err != nil {
    return fmt.Errorf("read daily sales: %w", err)
}
if err := tx.Commit(); err != nil {
    return fmt.Errorf("commit report transaction: %w", err)
}
一句话判断:只想声明“这个事务不写数据”时设置 ReadOnly: true;只有业务确实需要稳定的并发读取视图时才提高 Isolation。如果驱动不支持指定级别或只读属性,应该在 BeginTx 阶段处理错误,而不是继续执行事务。

TxOptions 的两个字段不是同一层含义

图1:begintx-error-path
图1:begintx-error-path

TxOptions 会传给 DB.BeginTx。Isolation 是 sql.IsolationLevel,设置为零值 LevelDefault 时使用驱动或数据库默认级别;ReadOnly 是布尔值,用来表达只读事务属性。

因此,下面几种组合含义不同:

配置表达的意图适合的场景
nil完全使用默认事务配置不需要额外约束的普通事务
ReadOnly: true只声明读事务报表、查询、校验类事务
Isolation: sql.LevelRepeatableRead请求稳定的重复读取同一事务内多次读取必须保持一致的场景
两者同时设置只读 + 指定隔离级别只读报表需要稳定视图的场景

这里的“适合”是业务选择,不是 Go 标准库替你决定的数据库策略。隔离级别的具体效果仍由数据库和驱动实现,不能只看 Go 常量名称。

TxOptions 的 ReadOnly 与 Isolation 分别连接到 BeginTx 和事务读取边界的静态结构说明图
图1:结构说明图,展示 TxOptions、ReadOnly、Isolation 与 BeginTx 的配置边界;这是静态 API 关系示意,不是运行结果截图。

在 BeginTx 中把两个选项放在同一个事务边界

不要先用 db.Begin() 开启事务,再期待后续代码补上只读或隔离配置。需要这些选项时直接使用 BeginTx,并让事务内的查询都通过返回的 tx 执行。

func loadReport(ctx context.Context, db *sql.DB, day string) (int64, error) {
    // 事务上下文同时控制 BeginTx 和后续查询,避免查询无限等待。
    tx, err := db.BeginTx(ctx, &sql.TxOptions{
        ReadOnly:  true,
        Isolation: sql.LevelRepeatableRead,
    })
    if err != nil {
        return 0, fmt.Errorf("begin report tx: %w", err)
    }
    // 任何提前返回都先尝试回滚;Commit 成功后事务已经结束。
    defer tx.Rollback()

    var total int64
    // 使用 tx 查询,不能改回 db.QueryRowContext,否则会离开当前事务。
    err = tx.QueryRowContext(ctx,
        "SELECT COALESCE(SUM(amount), 0) FROM sales WHERE sale_day = ?",
        day,
    ).Scan(&total)
    if err != nil {
        return 0, fmt.Errorf("query report: %w", err)
    }
    if err := tx.Commit(); err != nil {
        return 0, fmt.Errorf("commit report tx: %w", err)
    }
    return total, nil
}

这个写法的关键不是把字段写得更多,而是把边界写完整:

  • BeginTx 的错误单独处理,配置不被接受时不会进入半成品事务。
  • 查询通过 tx 发出,才真正处于这次事务的隔离边界内。
  • defer tx.Rollback() 覆盖查询失败和中途返回;提交成功后事务已结束,回滚结果可忽略。

Isolation 应该按一致性需求选择

Isolation 不是越高越好。零值让驱动或数据库采用默认级别,通常是最稳妥的起点;只有当同一个事务内的多次读取需要更强的稳定性时,才明确指定级别。

可以按下面的顺序判断:

  1. 如果一次事务只执行一条查询,先保留默认级别,避免无谓增加锁或冲突。
  2. 如果同一事务会读取同一批数据多次,并且中间不能看到变化,考虑 LevelRepeatableRead,但要确认数据库和驱动支持。
  3. 如果业务要求串行化地判断并写入,才评估 LevelSerializable;它可能增加等待、冲突和重试成本。

Go 的 IsolationLevel 常量只是跨驱动的表达方式,不会把不同数据库的实现差异抹平。不要把“配置成功”误读成“业务已经获得了某一种数据库理论模型的全部保证”。

BeginTx 报错时先判断是哪一个选项不被支持

图4:txoptions-fields
图4:txoptions-fields

官方文档明确说明:TxOptions 可以为 nil 使用默认配置;如果指定了驱动不支持的非默认隔离级别,BeginTx 会返回错误。驱动接口还要求检查 ReadOnly,支持时设置只读属性,不支持时返回错误。

func beginReadTx(ctx context.Context, db *sql.DB) (*sql.Tx, error) {
    // 先明确业务想要的配置,再把失败留在 BeginTx 入口。
    opts := &sql.TxOptions{
        ReadOnly:  true,
        Isolation: sql.LevelSerializable,
    }
    tx, err := db.BeginTx(ctx, opts)
    if err != nil {
        // 记录 opts,便于区分驱动能力错误与后续 SQL 错误。
        return nil, fmt.Errorf("unsupported transaction options (read_only=%t isolation=%s): %w",
            opts.ReadOnly, opts.Isolation.String(), err)
    }
    return tx, nil
}

排查时不要只看“事务开启失败”这一层。至少记录请求的 ReadOnly、Isolation 和原始错误;同一份代码换驱动或换数据库后,最先变化的往往就是这一步。

Context 和 TxOptions 通过 DB.BeginTx 连接到驱动 ConnBeginTx 与配置错误的静态关系图
图2:边界关系说明图,展示 BeginTx 把事务选项交给驱动并在不支持时返回错误的关系;不是运行结果截图。

Context 取消会改变事务收尾方式

DB.BeginTx 使用的 Context 会持续影响事务,直到提交或回滚。如果上下文被取消,database/sql 会回滚事务;此时再调用 Commit 会返回错误。对于报表查询,应该让同一个带截止时间的上下文贯穿开始、查询和提交,并把取消错误保留下来。

func reportWithDeadline(parent context.Context, db *sql.DB) error {
    // 截止时间限制整个事务,不只限制第一条 SQL。
    ctx, cancel := context.WithTimeout(parent, 2*time.Second)
    defer cancel()

    tx, err := db.BeginTx(ctx, &sql.TxOptions{ReadOnly: true})
    if err != nil {
        return err
    }
    // 查询出错、Context 取消或 Commit 失败都走这个兜底回滚。
    defer tx.Rollback()

    if _, err := tx.ExecContext(ctx, "SELECT 1"); err != nil {
        return fmt.Errorf("report query canceled or failed: %w", err)
    }
    if err := tx.Commit(); err != nil {
        return fmt.Errorf("report commit after context check: %w", err)
    }
    return nil
}

这里的 defer cancel() 负责释放上下文资源,defer tx.Rollback() 负责覆盖未提交路径。两者用途不同,不能因为事务是只读的就省略收尾。

发布前的 TxOptions 速查清单

  • 只读事务是否真的只执行查询,是否应该设置 ReadOnly: true?
  • 是否有明确的一致性理由需要指定 Isolation,还是默认级别已经足够?
  • 是否用 BeginTx 一次性传入选项,而不是先 Begin 再补配置?
  • 是否检查了 BeginTx 的错误,并记录具体选项?
  • 是否让事务内所有查询使用 tx,并为所有提前返回安排 Rollback?
  • Context 取消后是否接受事务回滚,并避免继续提交或复用已结束事务?

相关问题:

  • ReadOnly 为 false 时是不是一定允许写入? 不一定;它只是没有提出只读要求,最终仍由数据库权限、事务语句和驱动行为决定。
  • Isolation 设为零值会怎样? 使用驱动或数据库默认隔离级别,适合不需要额外一致性约束的普通事务。
  • 只读事务还需要 Commit 吗? 需要。事务仍然要以 Commit 或 Rollback 结束,不能把只读理解成无需收尾。

参考资料

Go database/sql TxOptions 官方文档、Go database/sql DB.BeginTx 官方文档、Go database/sql/driver ConnBeginTx 官方文档。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>