0

0

如何在Golang中实现错误分类处理_Golang switch与errors Is用法

P粉602998670

P粉602998670

发布时间:2026-01-19 17:12:08

|

248人浏览过

|

来源于php中文网

原创

应使用 errors.Is 判断底层错误类型,因其通过递归解包比较错误身份而非脆弱的文本匹配;配合 errors.As 进行类型断言,二者互补处理哨兵错误与自定义错误类型。

如何在golang中实现错误分类处理_golang switch与errors is用法

errors.Is 判断底层错误类型,不是看 error.Error() 文本

很多人一上来就用 strings.Contains(err.Error(), "timeout") 做分类,这非常脆弱:一旦底层库改了错误消息(比如加了前缀、翻译成英文),逻辑就崩了。Go 官方推荐的方式是用 errors.Is 检查是否包装了某个**哨兵错误(sentinel error)** 或实现了特定语义的错误。

比如 net/http 中的超时错误本质是包装了 context.DeadlineExceeded,而 os 包的文件不存在对应 os.ErrNotExist

if errors.Is(err, os.ErrNotExist) {
    log.Println("文件不存在,跳过处理")
} else if errors.Is(err, context.DeadlineExceeded) {
    log.Println("请求超时,触发降级")
} else if errors.Is(err, sql.ErrNoRows) {
    log.Println("数据库无匹配记录")
}

errors.Is 会逐层解包 fmt.Errorf("...: %w", err) 中的 %w,直到找到匹配的哨兵或确认不匹配,所以它依赖的是错误的「身份」,不是字符串。

switch 中不能直接 switch err,要配合 errors.Is 或类型断言

Go 的 switch 不支持对 error 接口做值比较(因为接口底层是 (type, value) 对),写 switch err { case os.ErrNotExist: ... } 是语法错误。正确做法分两类:

立即学习go语言免费学习笔记(深入)”;

  • 对已知哨兵错误:用多个 if/else if 链,或封装成函数返回分类标签
  • 对自定义错误类型:用类型断言 + switch 判断具体类型

例如你定义了多种业务错误:

MaxAI
MaxAI

MaxAI.me是一款功能强大的浏览器AI插件,集成了多种AI模型。

下载
type ValidationError struct{ Msg string }
type PermissionError struct{ Code int }

func (e ValidationError) Error() string { return "validation failed: " + e.Msg } func (e PermissionError) Error() string { return "permission denied" }

// 使用时: switch { case errors.As(err, &ValidationError{}): log.Printf("校验失败: %v", err) case errors.As(err, &PermissionError{}): log.Printf("权限不足,code=%d", err.(*PermissionError).Code) default: log.Printf("未知错误: %v", err) }

注意:errors.As 第二个参数必须传指针(如 &ValidationError{}),它会把匹配到的错误赋值给该指针指向的变量。

errors.Iserrors.As 的性能与兼容性要点

这两个函数从 Go 1.13 引入,如果你项目还跑在 1.12 或更早,不能直接用——得升级或手动实现简单版(不推荐)。实际使用中要注意:

  • errors.Is 开销很小,但每次调用都会递归解包,高频路径避免在循环里反复调用同一错误
  • errors.Aserrors.Is 稍重,因为它要做类型反射判断;如果确定只有一种可能类型,直接用 if e, ok := err.(*MyError); ok { ... } 更快
  • 第三方库若没用 %w 包装错误(比如直接 fmt.Errorf("xxx: %s", err)),errors.Iserrors.As 就失效,此时只能退回到文本匹配或检查 Unwrap() 方法

别漏掉「错误链末端」和「未包装错误」的兜底处理

真实服务中,错误来源复杂:标准库、中间件、DB 驱动、HTTP 客户端……有些错误根本没被 %w 包装,比如 json.Unmarshal 返回的原生 *json.SyntaxError。这时候 errors.Is(err, xxx) 会返回 false,但你仍可能想按类型处理。

稳妥做法是组合使用:

if errors.Is(err, os.ErrNotExist) {
    // 处理
} else if errors.Is(err, context.DeadlineExceeded) {
    // 处理
} else if se, ok := err.(*json.SyntaxError); ok {
    log.Printf("JSON 解析错在第 %d 行", se.Offset)
} else {
    log.Printf("其他错误:%+v", err)
}

关键点在于:errors.Is 和类型断言不是互斥的,而是互补的。前者管「语义等价」,后者管「具体类型行为」。漏掉任何一类,都可能让错误静默失败或误分类。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

178

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

209

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

392

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

196

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

191

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

11

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号