Golang使用errors.Is判断错误的正确方式_网络技术

Golang使用errors.Is判断错误的正确方式

发布时间 - 2026-01-12 00:00:00 点击率：次

errors.Is常返回false，因其仅检查错误链中是否存在同一底层错误值或指针，不支持字符串匹配；须用%w包裹、预定义变量或自定义Unwrap方法才能正确识别。

errors.Is 为什么经常返回 false？

因为 errors.Is 只检查错误链中是否存在某个**底层错误值（value）或其指针**，不支持字符串匹配、模糊比较或自定义逻辑。如果你用 errors.New("timeout") 创建的错误和另一个同内容的 errors.New("timeout") 比较，errors.Is 一定返回 false —— 它们是两个不同地址的指针。

必须用 errors.New 或 fmt.Errorf 包装原始错误才能用 errors.Is

只有当错误被显式地用 fmt.Errorf("...: %w", err) 或 errors.Join 等方式包裹（即包含 %w 动词），它才进入错误链；否则 errors.Is 查不到。

✅ 正确：用 %w 包裹底层错误
❌ 错误：只用 %s 或拼接字符串，如 fmt.Errorf("failed: %s", err.Error())
⚠️ 注意：errors.Unwrap 只能解一层，而 errors.Is 会自动遍历整个链（包括嵌套的 %w）

err := io.EOF
wrapped := fmt.Errorf("read failed: %w", err)
fmt.Println(errors.Is(wrapped, io.EOF)) // true

自定义错误类型要实现 Unwrap 方法

如果自己定义了错误结构体（比如 type MyError struct{ Msg string; Code int }），默认 errors.Is 查不到它是否等于某个值，除非你显式实现 Unwrap() error 并返回底层错误。

若该错误本身是终端错误（无底层），Unwrap 应返回 nil
若它封装了另一个错误（如调用了 io.ReadFull），就返回那个错误
不要在 Unwrap 中返回新构造的 errors.New —— 地址不同，errors.Is 仍失败

type MyError struct {
    Err error
}

func (e *MyError) Error() string { return "my error" }
func (e *MyError) Unwrap() error { return e.Err } // ✅ 这样 errors.Is 才能穿透

判断标准错误时，优先用预定义变量而非 errors.New

Go 标准库导出的错误（如 io.EOF、os.ErrNotExist）是包级变量，地址唯一。直接拿它们做 errors.Is(err, io.EOF) 是安全且推荐的；但千万别写成 errors.Is(err, errors.New("EOF"))。

立即学习“go语言免费学习笔记（深入）”；

✅ errors.Is(err, io.EOF)
✅ errors.Is(err, os.ErrNotExist)
❌ errors.Is(err, errors.New("file does not exist"))
⚠️ 第三方库若没暴露错误变量，应查文档看它是否实现了 Unwrap 或提供了 IsXXX() 辅助函数

实际项目中最容易漏掉的是：在中间层日志或转换错误时，下意识用了字符串拼接丢掉了 %w，导致上游再也无法用 errors.Is 判断原始错误类型。这个断点一旦出现，调试时就会发现“明明报了 EOF，却进不了 EOF 分支”。

# go # golang # app # ai # 标准库 # 为什么 # EOF # String # 封装 # Error # 字符串 # 结构体 # int # 指针 # Struct # nil # 自定义 # 不支持 # 的是 # 链中 # 中间层 # 遍历 # 它是 # 用了 # 时就 # 千万别

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：composer scripts 使用详解：如何定义自己的命

下一篇：VSCode PowerShell集成_Windows自动化

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：composer scripts 使用详解：如何定义自己的命

下一篇：VSCode PowerShell集成_Windows自动化