当前位置:首页 > 文章列表 > Golang > Go问答 > Go database/sql TxOptions 的 ReadOnly 和 Isolation 怎么配合

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

来源:17golang原创 2026-11-19 08:53:17 0浏览 收藏

在 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删除
Go database/sql.Conn.Close 后连接怎样回到连接池Go database/sql.Conn.Close 后连接怎样回到连接池
上一篇
Go database/sql.Conn.Close 后连接怎样回到连接池
Go big.Int.Not 为什么会把非负整数变成负数
下一篇
Go big.Int.Not 为什么会把非负整数变成负数
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1109次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1101次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1272次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1215次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1061次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码