0

0

如何使用Golang errors Is判断错误类型_Golang错误比较与判断方法

P粉602998670

P粉602998670

发布时间:2026-01-14 19:27:29

|

678人浏览过

|

来源于php中文网

原创

errors.Is不能判断自定义错误底层类型,因其仅通过调用错误链中各错误的Is方法判断语义相等,不进行类型断言或反射;若自定义错误未实现Is方法,则errors.Is恒返回false。

如何使用golang errors is判断错误类型_golang错误比较与判断方法

errors.Is 为什么不能判断自定义错误的底层类型

errors.Is 只检查错误链中是否存在「语义相等」的错误,即调用 Is(error) 方法返回 true 的错误。它不关心底层结构体类型,也不做类型断言或反射比对。

常见误解是以为 errors.Is(err, myErr) 能识别你定义的 *MyError 类型 —— 实际上,除非你显式实现了 Is 方法并让它返回 true,否则它永远返回 false

  • 标准库中的 os.ErrNotExistio.EOF 等能被 errors.Is 识别,是因为它们本身实现了 Is 方法
  • fmt.Errorf("xxx: %w", err) 包装后的错误,仍保留原错误的 Is 行为(前提是被包装的 err 支持)
  • 直接用 errors.New("xxx")fmt.Errorf("xxx") 创建的错误,不支持 Is 比较,只能靠 errors.As 或类型断言

什么时候该用 errors.As 而不是 errors.Is

当你需要获取错误的具体值(比如访问字段、调用方法),而不是只判断「是否等于某个哨兵错误」时,errors.As 是唯一选择。

例如:你定义了带状态码和消息的错误类型 *HTTPError,想取出它的 Code 字段 —— 这必须用 errors.As 提取指针,errors.Is 完全无能为力。

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

萝卜简历
萝卜简历

免费在线AI简历制作工具,帮助求职者轻松完成简历制作。

下载
  • errors.Is 返回 bool,适合 if/else 分支逻辑(如「如果文件不存在就创建」)
  • errors.As 返回 bool + 填充目标变量,适合需进一步操作错误值的场景
  • 若错误链里有多个同类型错误,errors.As 找到第一个匹配的并停止;不会继续向上遍历
var httpErr *HTTPError
if errors.As(err, &httpErr) {
    log.Printf("HTTP error code: %d", httpErr.Code)
}

自定义错误实现 Is 方法的最小必要写法

要让自己的错误能被 errors.Is 正确识别,必须在错误类型上实现 Is(target error) bool 方法,并确保逻辑可传递、无环、不依赖地址比较。

  • 不要用 == 直接比较接收者和 target(地址不同就失败)
  • 推荐方式:用 errors.As 尝试将 target 转成你的类型,再做字段级比较(如错误码、字符串消息)
  • 若你的错误只作为哨兵(如 ErrTimeout),可直接返回 target == ErrTimeout,但必须保证它是包级变量且永不重分配
type MyError struct {
    Code int
    Msg  string
}

func (e *MyError) Error() string { return e.Msg }
func (e *MyError) Is(target error) bool {
    var t *MyError
    if errors.As(target, &t) {
        return e.Code == t.Code
    }
    return false
}

errors.Is 在多层包装下的行为边界

errors.Is 会沿着 %w 包装链逐层调用 Unwrap(),直到遇到 nil 或某层返回 true。但它不会进入非标准包装(如自定义 WrappedError 但没实现 Unwrap)。

  • 如果中间某层错误的 Unwrap() 返回 nil,链就断了,后续错误不可达
  • 如果某层 Unwrap() 返回自身(造成循环),errors.Is 会 panic(Go 1.20+ 加了检测)
  • fmt.Errorf("wrap: %w", err) 是安全的;但手动实现 Unwrap 时务必确保返回的是另一个错误,不是自己

真正容易被忽略的是:即使你用了 %w,如果被包装的错误本身不支持 Is(比如纯字符串错误),那整条链对 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、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

337

2024.02.23

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

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

208

2024.03.05

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

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

388

2024.05.21

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

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

195

2025.06.09

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

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

190

2025.06.10

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

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

192

2025.06.17

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 3.7万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

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

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