如何使用Golang error.Is方法判断错误_比较目标错误对象

error.Is 用于判断错误链中是否包含指定目标错误值，通过逐层调用 Unwrap() 并用 == 比较各层错误值实现；需传入哨兵错误变量，不可传类型或临时错误实例。

error.Is 是 Go 1.13 引入的错误处理工具函数，用于判断一个错误链中是否**包含某个目标错误值（value）**，即是否与目标错误相等（==）。它适用于需要检查是否发生了某个特定错误（比如 io.EOF、os.ErrNotExist 或自定义的哨兵错误）的场景。

核心原理：逐层展开错误链并用 == 比较

error.Is(err, target) 会沿着 err 的错误链（通过 Unwrap() 方法）向上遍历，对每个错误值（包括 err 本身）执行 == 判断，只要任一环节满足 errX == target 就返回 true。

注意：它比对的是错误值（value），不是类型（type）。因此目标 target 必须是一个变量或常量（如哨兵错误），不能是类型（如 *os.PathError）。

正确用法：传入哨兵错误或已知错误实例

✅ 推荐方式：使用标准库或自定义的哨兵错误（var 变量）：

if errors.Is(err, io.EOF) { ... }
if errors.Is(err, os.ErrNotExist) { ... }
var ErrValidationFailed = errors.New("validation failed")
if errors.Is(err, ErrValidationFailed) { ... }

⚠️ 错误方式：传入类型、指针字面量或临时构造的错误：

errors.Is(err, &os.PathError{}) ❌（每次新建对象，地址不同）
errors.Is(err, (*os.PathError)(nil)) ❌（nil 指针无法 == 比较）
errors.Is(err, fmt.Errorf("xxx")) ❌（每次 new，值不等）

与 error.As 的区别：值 vs 类型

error.Is 关注“是不是这个错误”，而 error.As 关注“能不能转成这个类型”：

errors.Is(err, os.ErrNotExist) → 判断是否等于那个特定错误值
var pathErr *os.PathError; errors.As(err, &pathErr) → 判断错误链中是否有 *os.PathError 类型的实例，并提取出来

二者常配合使用：先用 Is 做快速哨兵匹配，再用 As 提取上下文信息（如路径、操作名）。

注意事项和常见陷阱

? 自定义错误若要支持 Is，需实现 Unwrap() error 方法返回下层错误（否则只比较自身）；
? 如果错误实现了 Is(error) bool 方法（Go 1.20+ 支持），errors.Is 会优先调用该方法，可用于更灵活的语义匹配；
? 不要对 nil 错误调用 errors.Is(nil, someErr) —— 它会返回 false（因为 nil == someErr 为假）；
? 多个哨兵可链式判断：if errors.Is(err, os.ErrNotExist) || errors.Is(err, os.ErrPermission) { ... }。

# go # golang # 工具 # ai # 区别 # 标准库 # EOF # 常量 # if # Error # bool # 指针 # var # nil # 对象 # 自定义 # 链式 # 链中 # 的是 # 是一个 # 多个 # 遍历 # 适用于 # 要对 # 再用

返回目录在线咨询

上一篇：Java AOP知识详细介绍
下一篇：Shopyy自建站支持哪些物流和配送选项？

您的项目需求