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

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

error.Is 是 Go 1.13 引入的错误处理工具函数,用于判断一个错误链中是否**包含某个目标错误值(value)**,即是否与目标错误相等(==)。它适用于需要检查是否发生了某个特定错误(比如 io.EOFos.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) { ... }