17370845950

如何在Golang中判断错误类型_使用类型断言和errors.As方法
Go中判断错误类型应按场景选择:精确匹配未包装错误用类型断言;检查错误链中是否存在某类型用errors.As;判断是否等于哨兵错误用errors.Is。

在 Go 中判断错误类型,核心是区分“是否为某类错误”和“是否包含某类错误”。类型断言适合精确匹配具体错误类型(如 *os.PathError),而 errors.As 更适用于检查错误链中是否存在某个目标类型的错误(支持包装错误,如用 fmt.Errorf("xxx: %w", err) 包装的情况)。

用类型断言判断具体错误类型

当明确知道错误变量可能直接是某个具体类型(未被包装)时,可用类型断言:

  • 语法为 err.(*os.PathError) 或更安全的双返回值形式:if pe, ok := err.(*os.PathError); ok { ... }
  • 只对**最外层错误**生效,若错误被 %w 包装过(如 fmt.Errorf("open failed: %w", pe)),断言会失败
  • 适用于标准库中常见错误类型,例如:*os.PathError*net.OpError*exec.ExitError

用 errors.As 检查错误链中的目标类型

errors.As 会沿着错误链(通过 Unwrap())逐层查找,只要某一层是目标类型或实现了该接口,就返回 true:

  • 使用方式:var pe *os.PathError; if errors.As(err, &pe) { ... }(注意传入指针地址)
  • 自动处理多层包装,比如 fmt.Errorf("read: %w", fmt.Errorf("io: %w", pe)) 也能成功匹配 *os.PathError
  • 也支持接口类型,例如检查是否实现了 interface{ Timeout() bool }

errors.Is 用于判断是否为特定错误值

如果要判断错误是否等于某个预定义的错误变量(如 os.ErrNotExist),应使用 errors.Is

  • if errors.Is(err, os.ErrNotExist) { ... }
  • 它同样遍历错误链,比较每一层是否 == 目标值,适合哨兵错误(sentinel errors)
  • 不要用 == 直接比较,因为包装后的错误地址不同

实际使用建议

优先按场景选择:

  • 想确认是否是某个自定义错误结构体?→ 用 errors.As
  • 想确认是否等于某个全局错误变量(如 sql.ErrNoRows)?→ 用 errors.Is
  • 确定错误没被包装且需快速判断?→ 类型断言可读性高,但不够健壮
  • 写公共库或处理用户传入的错误时,一律推荐 errors.Aserrors.Is