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 的两个字段不是同一层含义

TxOptions 会传给 DB.BeginTx。Isolation 是 sql.IsolationLevel,设置为零值 LevelDefault 时使用驱动或数据库默认级别;ReadOnly 是布尔值,用来表达只读事务属性。
因此,下面几种组合含义不同:
| 配置 | 表达的意图 | 适合的场景 |
|---|---|---|
nil | 完全使用默认事务配置 | 不需要额外约束的普通事务 |
ReadOnly: true | 只声明读事务 | 报表、查询、校验类事务 |
Isolation: sql.LevelRepeatableRead | 请求稳定的重复读取 | 同一事务内多次读取必须保持一致的场景 |
| 两者同时设置 | 只读 + 指定隔离级别 | 只读报表需要稳定视图的场景 |
这里的“适合”是业务选择,不是 Go 标准库替你决定的数据库策略。隔离级别的具体效果仍由数据库和驱动实现,不能只看 Go 常量名称。

在 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 不是越高越好。零值让驱动或数据库采用默认级别,通常是最稳妥的起点;只有当同一个事务内的多次读取需要更强的稳定性时,才明确指定级别。
可以按下面的顺序判断:
- 如果一次事务只执行一条查询,先保留默认级别,避免无谓增加锁或冲突。
- 如果同一事务会读取同一批数据多次,并且中间不能看到变化,考虑
LevelRepeatableRead,但要确认数据库和驱动支持。 - 如果业务要求串行化地判断并写入,才评估
LevelSerializable;它可能增加等待、冲突和重试成本。
Go 的 IsolationLevel 常量只是跨驱动的表达方式,不会把不同数据库的实现差异抹平。不要把“配置成功”误读成“业务已经获得了某一种数据库理论模型的全部保证”。
BeginTx 报错时先判断是哪一个选项不被支持

官方文档明确说明: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 取消会改变事务收尾方式
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 官方文档。
-
369 收藏
-
344 收藏
-
464 收藏
-
187 收藏
-
327 收藏
-
Golang · Go问答 | 22分钟前 | 标准库 · 连接池 · database/sql · Go问答 · Go 连接池 database/sql 连接生命周期 sql.Conn Conn.Close ErrConnDone426 收藏
-
315 收藏
-
Golang · Go问答 | 33分钟前 | 标准库 · HTTP · Go问答 · Go 重复请求头 MIMEHeader.Values 首个值 textproto.MIMEHeader.Get 请求头大小写300 收藏
-
Golang · Go问答 | 46分钟前 | 结构体 · 标准库 · 错误处理 · Go问答 · Go io.ErrUnexpectedEOF encoding/binary.Read 结构体空白字段 协议填充 binary.Size330 收藏
-
106 收藏
-
285 收藏
-
358 收藏
-
235 收藏
-
270 收藏
-
405 收藏
-
327 收藏
-
286 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习