Go database/sql 如何处理 Rows.Close 错误:事务提交前的资源回收顺序
线上批量导入偶尔出现“事务已经提交,但结果不完整”的告警,排查时很容易只盯着 rows.Err(),却漏掉 Rows.Close 返回的错误。对 database/sql 来说,读取结束、关闭结果集和提交事务是三个不同的检查点;把它们揉成一个 defer,就可能在提交后才发现连接或驱动层的问题。
在事务内查询时,应先确认
rows.Err(),再显式处理rows.Close(),两个检查都通过后才调用Commit;任一点失败,都走Rollback。
要点速览
rows.Next()返回 false 不等于查询完整成功,还要看rows.Err()。rows.Close()负责释放结果集资源,也可能返回错误,不能只写成无视返回值的 defer。- 事务提交前检查读取错误和关闭错误,失败分支统一回滚。
- 关闭成功后再提交,提交失败仍要记录并交给上层处理。
为什么 rows.Next 结束后还要检查两次
database/sql.Rows 把结果集读取封装成迭代器。Next 返回 false 可能表示没有下一行,也可能表示读取途中发生了错误;真正的读取结论要由 rows.Err() 给出。另一方面,Close 负责结束结果集,驱动可能在这里完成最后的网络读取或资源释放,因此它和 Err 不是同一个信号。
这也是为什么“循环结束就提交”不够稳:循环只说明迭代动作停了,不说明数据已经完整落地。

把关闭动作放到 Commit 之前
下面的示例以一个事务内的库存同步为背景。查询本身只读取 inventory_delta,真正的写入省略为注释,重点是四个真实节点:QueryContext、rows.Next、rows.Err、rows.Close。
func syncInventory(ctx context.Context, db *sql.DB) error {
tx, err := db.BeginTx(ctx, nil)
if err != nil {
return err
}
rows, err := tx.QueryContext(ctx, `
SELECT sku, delta
FROM inventory_delta
WHERE batch_id = ?
ORDER BY sku`, batchID)
if err != nil {
_ = tx.Rollback()
return err
}
for rows.Next() {
var sku string
var delta int
if err := rows.Scan(&sku, &delta); err != nil {
_ = rows.Close()
_ = tx.Rollback()
return err
}
// 在事务内写入库存变更。
}
if err := rows.Err(); err != nil {
_ = rows.Close()
_ = tx.Rollback()
return err
}
if err := rows.Close(); err != nil {
_ = tx.Rollback()
return err
}
return tx.Commit()
}
示例里没有使用无条件的 defer rows.Close() 来代替显式检查。实际项目可以再加一个兜底关闭,但兜底动作不应掩盖提交前的主检查。
Scan 出错时为什么先关 rows
Scan 失败时,当前结果集已经不能继续推进。先调用 rows.Close(),再回滚事务,可以尽早归还驱动资源。关闭本身若也失败,应把它写入日志或错误链,但不要因为记录关闭错误而跳过回滚。
读错、关错和提交错要分开记录
三类错误的责任边界不同:rows.Err() 更接近读取阶段,rows.Close() 更接近结果集收尾,Commit 则表示事务最终提交动作。日志至少应带上 batch_id,否则同一批数据的失败阶段很难区分。

一个实用的处理顺序是:
- 查询创建失败:立即
Rollback,不创建后续读取流程。 Scan或rows.Err()失败:停止读取,先关闭结果集,再回滚。rows.Close()失败:不提交,回滚并记录关闭阶段。Commit失败:记录提交错误,交给调用方决定重试或人工核对。
测试时要验收哪些可见结果
不要只断言函数返回 nil。正常路径应能看到提交后的库存变化;读取错误路径应确认写入没有对外可见;关闭错误路径则要确认没有继续调用 Commit。如果使用可注入的数据库驱动,分别让查询读取、结果集关闭和提交返回错误,三个分支都应有独立测试。
生产日志建议包含批次号、阶段名和事务结果,例如 rows_read、rows_close、commit。不要把数据库密码、完整 DSN 或用户输入拼进错误文本。
常见问题
rows.Next 返回 false 就代表没有错误吗?
不代表。它既可能表示正常读完,也可能表示读取错误;必须继续检查 rows.Err()。
已经 defer rows.Close 了,还要显式 Close 吗?
如果关闭错误会影响事务是否提交,就应在提交前显式调用并检查返回值;defer 可以作为异常退出时的兜底。
rows.Close 出错后能不能继续 Commit?
不建议。关闭失败说明结果集收尾未被确认,当前事务应回滚,并记录批次和关闭阶段。
小结
database/sql 的安全收尾不是“循环结束后直接提交”,而是把数据读取、结果集关闭和事务提交按顺序验收。只要把 rows.Err() 与 rows.Close() 放到 Commit 之前,失败就统一回滚,批量同步的异常边界会清楚很多。
Java ModuleLayer 如何隔离插件依赖:模块解析、层级加载与卸载边界
- 上一篇
- Java ModuleLayer 如何隔离插件依赖:模块解析、层级加载与卸载边界
- 下一篇
- Java Locale.forLanguageTag 为什么解析后语言标签变了:规范化、扩展字段与缓存键
-
- Golang · Go教程 | 24分钟前 | 标准库 · go · Go 流式读取 io.TeeReader io.Reader io.Writer
- Go io.TeeReader 怎样同时读取和记录数据
- 454浏览 收藏
-
- Golang · Go教程 | 27分钟前 | 标准库 · go · 性能优化 · 性能 Go bytes.Equal 字节序列比较
- Go bytes.Equal 怎样比较大字节序列
- 211浏览 收藏
-
- Golang · Go教程 | 30分钟前 | 字符串拼接 strings.Builder Grow
- Go strings.Builder 怎样减少字符串拼接分配
- 299浏览 收藏
-
- Golang · Go教程 | 32分钟前 |
- Go httptrace 怎样定位连接建立耗时
- 364浏览 收藏
-
- Golang · Go教程 | 35分钟前 | 超时 · go · 性能 · HTTP客户端 · Go net/http HTTP超时 http.Transport ResponseHeaderTimeout
- Go http.Transport 怎样设置 ResponseHeaderTimeout 防止请求久等
- 133浏览 收藏
-
- Golang · Go教程 | 55分钟前 | 错误处理 · go · 重定向 · HTTP客户端 · 重定向 Go net/http http.Client CheckRedirect
- Go http.Client CheckRedirect 怎样限制重定向次数
- 484浏览 收藏
-
- Golang · Go教程 | 1小时前 |
- Go net/http 怎样设置请求体大小上限
- 444浏览 收藏
-
- Golang · Go教程 | 1小时前 | 日志 · HTTP · go · Context · slog · 可观测性 · Go context.Context 结构化日志 请求日志 log/slog slog.Logger
- Go log/slog 怎样给每个请求添加上下文
- 136浏览 收藏
-
- Golang · Go教程 | 1小时前 | go · slog · Go 日志脱敏 ReplaceAttr slog.Handler
- Go slog.Handler 怎样过滤敏感字段
- 419浏览 收藏
-
- Golang · Go教程 | 1小时前 | 错误处理 · go · Go 错误包装 fmt.Errorf errors.Is
- Go fmt.Errorf 怎样正确包装可检查错误
- 136浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 463次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 527次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 545次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 494次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 313次使用
-
- Go map 并发写 panic 怎么办:从共享 map 到可控写入路径
- 2026-06-30 123浏览
-
- Go代码规范错误处理示例经验总结
- 2022-12-23 278浏览
-
- go语言中的defer关键字
- 2023-02-17 150浏览
-
- Golang中Interface接口的三个特性
- 2023-01-07 394浏览
-
- go语言中函数与方法介绍
- 2023-01-07 297浏览

