如何在Golang中判断错误类型_使用errors.Is和errors.As

推荐使用 errors.Is 和 errors.As 判断错误类型:errors.Is(err, target) 沿错误链检查是否等于哨兵错误(如 os.ErrNotExist);errors.As(err, &target) 提取第一个匹配的底层错误值(如 *os.PathError)。

在 Go 中判断错误类型,推荐使用 errors.Iserrors.As,它们是 Go 1.13 引入的标准方式,能安全、准确地处理包装错误(wrapped errors),替代过去容易出错的类型断言或 == 比较。

用 errors.Is 判断是否为某个具体错误

errors.Is(err, target) 会沿着错误链向上检查,看是否有某一层错误与 target 相等(基于 Is() 方法或值比较)。适合判断是否发生了某个预定义的错误(如 io.EOF、自定义的 sentinel error)。

  • 必须使用哨兵错误(sentinel error),例如 var ErrNotFound = errors.New("not found"),而不是每次 errors.New("not found") 新建
  • 支持标准库中已实现 Is() 方法的错误,比如 os.ErrNotExistio.EOF
  • 示例:if errors.Is(err, os.ErrNotExist) { /* 处理文件不存在 */ }

用 errors.As 提取底层错误值或结构体

errors.As(err, &target) 尝试将错误链中第一个匹配的错误赋值给 target(需是指针)。适合需要访问错误内部字段或调用其方法的场景,比如获取 *os.PathErrorPathErr 字段。

  • target 必须是指向接口或具体类型的指针,例如 *os.PathError*MyCustomError
  • 它只解包一层匹配项,不遍历全部;若错误链中有多个同类型错误,只取最内层(最先被包装的那个)
  • 示例:var pathErr *os.PathError
    if errors.As(err, &pathErr) { fmt.Println("路径错误:", pathErr.Path) }

避免常见误区

直接用 err == someErr 只能匹配最外层错误,对 fmt.Errorf("wrap: %w", origErr) 这类包装错误失效;而类型断言 err.(*MyErr) 无法穿透多层包装,且 panic 风险高。

  • 不要用 reflect.TypeOf(err) == reflect.TypeOf(&MyErr{}) —— 不安全、不标准、无法处理包装
  • 不要在未确认类型前对 err 做强制类型转换
  • 自定义错误建议实现 Unwrap() error(如果可包装)和 Is(error) bool(如果需参与 errors.Is 判断)

组合使用更健壮

实际中常先用 errors.Is 做粗粒度判断(是否是某类业务错误),再用 errors.As 提取细节进一步处理。

  • 例如:先 errors.Is(err, ErrValidationFailed) 判断是否校验失败,再 errors.As(err, &validationErr) 获取具体哪个字段出错
  • 注意顺序:先 IsAs 更高效,因为 Is 通常更快;若只需提取信息,可直接 As