如何在Golang中捕获并处理多个错误_Golang多重错误处理与管理方法
一分耕耘,一分收获!既然打开了这篇文章《如何在Golang中捕获并处理多个错误_Golang多重错误处理与管理方法》,就坚持看下去吧!文中内容包含等等知识点...希望你能在阅读本文后,能真真实实学到知识或者帮你解决心中的疑惑,也欢迎大佬或者新人朋友们多留言评论,多给建议!谢谢!
Go不支持多异常抛出,需用errors.Join聚合错误(Go1.20+)、手动收集错误切片分类处理,或借助multierr库;错误链仅适用于单向嵌套,不适用于并列错误。

Go 语言原生不支持“抛出多个错误”或“嵌套异常”,error 是接口,单次返回只能是一个值;想“捕获并处理多个错误”,本质是**聚合、分类、延迟判断或组合上报**,不是 try-catch 多 catch 块那种逻辑。
用 errors.Join 合并多个 error(Go 1.20+)
当你在循环或并行操作中积累多个独立错误(比如批量写文件、并发请求),需要统一返回而非提前中断时,errors.Join 是最直接的方式。它返回一个实现了 error 接口的组合错误,调用 Error() 会拼接所有子错误信息。
注意:errors.Join 忽略 nil,且结果不可逆向拆解 —— 它只适合“最终上报”,不适合后续分支处理。
- 如果任一子错误为
nil,会被自动跳过 - 返回的 error 不支持类型断言还原原始错误(除非你自己封装)
- 不要用它替代业务逻辑判断:比如“3 个请求失败了 2 个”,应单独计数,不能只依赖
errors.Join的字符串输出
err := errors.Join(
os.WriteFile("a.txt", []byte("1"), 0644),
os.WriteFile("b.txt", []byte("2"), 0644),
os.WriteFile("c.txt", []byte("3"), 0644),
)
if err != nil {
log.Println("批量写入失败:", err) // 输出类似 "2 errors occurred: ...; ..."
}
手动构建错误切片 + 自定义 error 类型
当你要对多个错误做差异化处理(比如重试部分、忽略特定码、统计失败率),就不能只靠 errors.Join。更可控的做法是收集 []error,再根据业务规则决策。
常见场景:HTTP 批量调用后,需区分 404(跳过)、500(重试)、超时(告警)。
- 避免直接用
fmt.Errorf("%w; %w", a, b)拼接 —— 这会丢失堆栈和原始类型信息 - 若需保留每个错误的上下文,可定义结构体如
type BatchError struct { Op string; Err error; Index int } - 检查是否含某类错误时,用
errors.Is(err, target)或errors.As(err, &target)对组合 error 无效,必须作用于原始项
var errs []error
for i, url := range urls {
if resp, err := http.Get(url); err != nil {
errs = append(errs, fmt.Errorf("fetch[%d] %s: %w", i, url, err))
}
}
// 后续可遍历 errs 单独分析
使用 multierr 库(兼容老版本 Go)
Go 1.20 前没有 errors.Join,社区广泛使用 go.uber.org/multierr。它的行为更灵活:支持追加、过滤、折叠,并保留第一个非-nil 错误作为“主错误”(可用于 errors.Is 判断)。
但要注意:它默认不导出内部错误列表,若需遍历仍得用 multierr.Errors(err) 解包。
multierr.Append(a, b)类似errors.Join,但返回 error 中第一个非-nil 项可被errors.Is匹配- 若你依赖
errors.Is(err, fs.ErrNotExist)判断组合错误是否含某个底层错误,multierr默认不支持,需手动解包 - 引入第三方库会增加依赖链,纯标准库项目慎用
别把“多个错误”和“错误链”混淆
Go 的错误链(%w 包装)是单向嵌套,用于表达“因为 A 所以 B”,不是并列关系。多个错误并列时,错误链模型天然不适用 —— 你不能用 fmt.Errorf("failed: %w and %w", err1, err2),语法不合法。
真正需要并列语义时,必须显式选择聚合方式(切片、Join、自定义结构),而不是试图用链式包装模拟。
最容易被忽略的一点:日志记录多个错误时,别只打 err.Error() —— 它可能只显示第一个或摘要,丢失细节;应遍历原始错误集合,逐条记录带上下文的完整信息。
好了,本文到此结束,带大家了解了《如何在Golang中捕获并处理多个错误_Golang多重错误处理与管理方法》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多Golang知识!
index.html如何实现图片懒加载功能?
- 上一篇
- index.html如何实现图片懒加载功能?
- 下一篇
- HTML怎么做导出CSV_html表格数据导出CSV文件方法【技巧】
-
- Golang · Go教程 | 12小时前 | map · 并发安全 · RWMutex · sync.Map · Go教程 · 并发安全 RWMutex sync.Map Go map并发读写 go test race
- Go map 并发读写崩溃怎么办:从复现报错到 RWMutex 修复的完整流程
- 272浏览 收藏
-
- Golang · Go教程 | 2天前 | singleflight · 并发控制 · Go教程 · 缓存治理 · 接口优化 · Go 并发请求 缓存击穿 singleflight 缓存回填
- Go singleflight 防缓存击穿实战:相同请求只查一次数据库
- 114浏览 收藏
-
- Golang · Go教程 | 3天前 | golang
- Go 线上故障复盘模板:日志、指标、链路追踪与 pprof 证据闭环
- 710浏览 收藏
-
- Golang · Go教程 | 3天前 | golang
- Go 微服务超时、重试与熔断观测:避免故障放大的实践
- 687浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- 剧云
- 剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
- 75次使用
-
- 万象有声
- 万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
- 76次使用
-
- Red Skill
- 小红书创作服务平台为小红书创作者和机构提供视频上传、数据分析、粉丝管理、创作指导等多项运营服务,助力用户解锁更多创作者专属功能,体验高效创作!
- 83次使用
-
- MiMo Code
- MiMo Code 是小米大模型团队开源的新一代 AI 编程助手,面向开发者提供代码理解、生成与辅助开发能力,适合作为 AI 编程工具收藏和体验。
- 177次使用
-
- TRAE Work
- TRAE AI IDE | 国内首款 AI 原生集成开发环境,深度集成 Doubao-1.5-pro 与 DeepSeek 模型,支持中文自然语言一键生成完整代码框架,实时预览前端效果并智能修复 BUG。首创 Builder 模式实现需求到代码的自动化开发,兼容 Windows/macOS 系统,官网下载即用。
- 203次使用
-
- Java 性能优化上线清单:从定位、改造到灰度发布
- 2026-06-11 860浏览
-
- Spring Boot 压测验证:Gatling、JMeter 与性能回归门禁
- 2026-06-11 843浏览
-
- Java NMT 非堆内存排查:Direct Buffer、线程栈与 Metaspace 分析
- 2026-06-11 826浏览
-
- Spring Boot 容器内存优化:JVM 堆、非堆与 MaxRAMPercentage
- 2026-06-11 809浏览
-
- Tomcat 连接与线程参数调优:maxThreads、acceptCount 与 KeepAlive
- 2026-06-11 792浏览

