Golang自定义错误创建与包装详解
“纵有疾风来,人生不言弃”,这句话送给正在学习Golang的朋友们,也希望在阅读本文《Golang自定义错误创建与错误包装详解》后,能够真的帮助到大家。我也会在后续的文章中,陆续更新Golang相关的技术文章,有好的建议欢迎大家在评论留言,非常感谢!
在 Golang 中,错误处理应优先使用结构体实现 error 接口以携带额外信息,1. 自定义错误类型通过实现 Error() 方法支持类型判断与信息扩展;2. 简单错误可用 errors.New 或 fmt.Errorf,但不便于类型提取;3. 使用 fmt.Errorf 的 %w 动词包装错误可保留原始信息;4. 解包错误可通过 errors.Unwrap、errors.Is 和 errors.As 遍历错误链进行匹配或类型提取;5. 实践中应优先使用 errors.As 判断类型,避免随意包装无上下文的错误,关键路径添加上下文再包装,并避免字符串比较以提升可靠性与可维护性。
在 Golang 中,错误处理是程序设计的重要组成部分。errors
库提供了创建、包装和解包错误的能力,让我们可以写出更清晰、可维护的错误逻辑。下面我们就来看看如何使用 errors
包来创建自定义错误,并演示错误包装与解包的最佳实践。

自定义错误类型:实现 error 接口
最基础的方式是通过定义一个结构体并实现 error
接口的 Error() string
方法:

type MyError struct { Msg string } func (e MyError) Error() string { return "MyError: " + e.Msg }
这样你就可以像使用标准错误一样使用它:
err := MyError{"something went wrong"} fmt.Println(err)
这种方式适合需要携带额外信息的场景,比如错误码、状态、发生位置等。你可以扩展这个结构体,加入更多字段以供后续处理。

使用 errors.New 和 fmt.Errorf 创建简单错误
对于不需要附加额外信息的错误,直接使用 errors.New
就够用了:
err := errors.New("this is a simple error")
如果需要格式化错误信息,可以用 fmt.Errorf
:
err := fmt.Errorf("invalid value: %d", val)
但要注意的是,这两种方式创建的错误都是“裸”的字符串错误,不便于做类型判断或提取上下文信息。所以,在需要做错误类型区分时,还是建议用上面的结构体方式。
错误包装(Wrap):保留原始错误信息
Go 1.13 引入了 fmt.Errorf
的 %w
动词来进行错误包装:
err := fmt.Errorf("failed to read config: %w", originalErr)
这会把 originalErr
包装进新的错误中,方便后续调用者使用 errors.Unwrap()
或 errors.As()
提取原始错误。
注意:只有使用
%w
格式符包装的错误才能被正确解包。其他方式(如拼接字符串)无法保留原始错误结构。
错误解包(Unwrap):提取原始错误进行判断
如果你得到了一个被包装过的错误,想判断它是否是由某个特定错误引起的,可以用以下方法:
errors.Unwrap(err)
:获取包装错误的下一层错误。errors.Is(err, target)
:判断某层错误是否等于目标错误。errors.As(err, &target)
:判断某层错误是否是指定类型的错误。
例如:
if errors.Is(err, os.ErrNotExist) { // 处理文件不存在的情况 }
或者检查自定义错误类型:
var myErr *MyError if errors.As(err, &myErr) { fmt.Println("Got a MyError with message:", myErr.Msg) }
这些方法会自动遍历整个错误链,直到找到匹配项为止,非常实用。
实践建议:怎么用才合理?
优先使用 errors.As 而不是 type switch
因为errors.As
可以处理嵌套包装的错误,而 type switch 只能判断当前层级的错误类型。不要随意包装所有错误
如果你只是传递错误而不加任何上下文信息,就不需要用%w
。否则会让错误链变得复杂且难以理解。在关键路径上添加上下文信息再包装
比如在函数调用栈的高层加上操作失败的原因,这样调试时更容易定位问题。避免只比较错误字符串
字符串比较不稳定,容易因为拼写错误或语句变化而出错。应该尽量使用类型或变量对比。
基本上就这些。Golang 的错误机制虽然看起来简单,但在实际项目中要处理得当,还是要靠合理的包装和解包策略。用好 errors
包提供的工具,可以让你的错误处理更清晰、更可靠。
以上就是《Golang自定义错误创建与包装详解》的详细内容,更多关于golang,错误处理,自定义错误,错误包装,错误解包的资料请关注golang学习网公众号!

- 上一篇
- JavaLambda表达式详解与应用技巧

- 下一篇
- 豆包AI如何解析Python日志数据
-
- Golang · Go教程 | 4分钟前 |
- Go1.18+Fuzz测试入门教程
- 494浏览 收藏
-
- Golang · Go教程 | 6分钟前 |
- Golang反射优化与替代方案解析
- 390浏览 收藏
-
- Golang · Go教程 | 13分钟前 |
- Golang处理带BOM的CSV读写方法
- 402浏览 收藏
-
- Golang · Go教程 | 14分钟前 |
- Golang容器构建优化与多阶段实践详解
- 231浏览 收藏
-
- Golang · Go教程 | 25分钟前 |
- PHPStormDebian版怎么选?
- 379浏览 收藏
-
- Golang · Go教程 | 31分钟前 |
- Golang错误日志:logrus与上下文实战指南
- 422浏览 收藏
-
- Golang · Go教程 | 31分钟前 |
- Golang微服务认证:JWT与OAuth2实战教程
- 310浏览 收藏
-
- Golang · Go教程 | 33分钟前 |
- Golang反射类型转换技巧解析
- 392浏览 收藏
-
- Golang · Go教程 | 34分钟前 |
- Golang代理模式:接口包装控制访问
- 348浏览 收藏
-
- Golang · Go教程 | 35分钟前 |
- Golang微服务缓存方案:Redis与内存多级设计
- 496浏览 收藏
-
- Golang · Go教程 | 38分钟前 |
- Golang集成Prose实现NLP处理方法
- 172浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 509次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 497次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 484次学习
-
- 边界AI平台
- 探索AI边界平台,领先的智能AI对话、写作与画图生成工具。高效便捷,满足多样化需求。立即体验!
- 391次使用
-
- 免费AI认证证书
- 科大讯飞AI大学堂推出免费大模型工程师认证,助力您掌握AI技能,提升职场竞争力。体系化学习,实战项目,权威认证,助您成为企业级大模型应用人才。
- 405次使用
-
- 茅茅虫AIGC检测
- 茅茅虫AIGC检测,湖南茅茅虫科技有限公司倾力打造,运用NLP技术精准识别AI生成文本,提供论文、专著等学术文本的AIGC检测服务。支持多种格式,生成可视化报告,保障您的学术诚信和内容质量。
- 542次使用
-
- 赛林匹克平台(Challympics)
- 探索赛林匹克平台Challympics,一个聚焦人工智能、算力算法、量子计算等前沿技术的赛事聚合平台。连接产学研用,助力科技创新与产业升级。
- 640次使用
-
- 笔格AIPPT
- SEO 笔格AIPPT是135编辑器推出的AI智能PPT制作平台,依托DeepSeek大模型,实现智能大纲生成、一键PPT生成、AI文字优化、图像生成等功能。免费试用,提升PPT制作效率,适用于商务演示、教育培训等多种场景。
- 548次使用
-
- Golangmap实践及实现原理解析
- 2022-12-28 505浏览
-
- 试了下Golang实现try catch的方法
- 2022-12-27 502浏览
-
- Go语言中Slice常见陷阱与避免方法详解
- 2023-02-25 501浏览
-
- Golang中for循环遍历避坑指南
- 2023-05-12 501浏览
-
- Go语言中的RPC框架原理与应用
- 2023-06-01 501浏览