Golang错误判断：errors.Is与errors.As详解

在Go语言错误处理中，`errors.Is`和`errors.As`是正确应对错误链（error wrapping）的两大核心工具：`errors.Is`用于语义化判断错误是否等价于某个预定义错误（如`io.EOF`或`os.ErrNotExist`），避免因错误实例不同导致的`==`比较失败；而`errors.As`则用于安全提取错误链中首个匹配的具体类型（如`*os.PathError`），从而访问其字段或方法，解决多层包装下类型断言失效的痛点。二者分工明确——前者回答“是不是这个错误”，后者回答“它具体是什么类型、能做什么”，合理组合使用可构建健壮、可维护的错误处理逻辑，尤其在自定义错误需支持深度集成时，还需显式实现`Is`和`As`方法。

errors.Is 用来判断错误是否等于某个特定错误值

errors.Is 检查错误链中是否存在与目标错误 相等 的错误（基于 == 或 Is() 方法）。它适合判断是否是某个预定义的错误变量，比如 io.EOF、os.ErrNotExist，或你自己用 errors.New 创建的全局错误。

常见错误现象：用 == 直接比较两个错误值，结果为 false —— 因为底层可能是不同实例，即使内容相同也不相等。

• 只对实现了 error 接口且支持语义相等（如 os.PathError、net.OpError）或本身就是同一变量的错误有效
• 不适用于自定义错误结构体，除非你显式实现 Is(target error) bool 方法
• 对包装错误（如 fmt.Errorf("wrap: %w", err)）会自动解包检查整条链

err := os.Open("missing.txt")
if errors.Is(err, os.ErrNotExist) {
    fmt.Println("文件不存在") // ✅ 触发
}

errors.As 用来提取并赋值错误底层的具体类型

errors.As 尝试将错误链中某个错误转换为指定类型，并把结果写入提供的指针变量。它解决的是“这个错误是不是某种具体结构体/接口类型”的问题，比如想拿到 *os.PathError 里的 Path 字段，或判断是否实现了某个自定义接口。

常见错误现象：直接类型断言 err.(*os.PathError) 失败 —— 因为错误被多层包装，原始类型藏在底层。

• 第二个参数必须是指向接口或具体类型的非 nil 指针，否则 panic
• 它会遍历整个错误链（包括 %w 包装的），找到第一个匹配的类型就停止
• 如果错误链中没有匹配类型，返回 false，目标变量保持原值（不会清零）

err := os.Open("/tmp/../bad/path.txt")
var pathErr *os.PathError
if errors.As(err, &pathErr) {
    fmt.Println("路径错误:", pathErr.Path) // ✅ 输出 "/tmp/../bad/path.txt"
}

什么时候该用 Is，什么时候该用 As

核心区别在于：你要比的是「值相等」还是「类型归属」。

• 用 errors.Is(err, io.EOF)：你只关心“是不是 EOF”，不关心它从哪来、有没有包装
• 用 errors.As(err, &pathErr)：你需要访问错误内部字段（如 pathErr.Path、pathErr.Err），或需要调用其特有方法
• 两者可组合使用：先 As 提取类型，再根据该类型做更细粒度判断；或先 Is 快速过滤，再 As 深入处理

注意：不要对同一个错误反复调用 As 去尝试多种类型 —— 它只返回第一个匹配项，顺序依赖错误链结构，不是“所有可能类型”。

自定义错误类型要支持 As 和 Is 需要手动实现方法

如果你定义了自己的错误结构体，并希望它能被 errors.As 正确识别或参与 errors.Is 判断，必须显式实现 As(interface{}) bool 和/或 Is(error) bool 方法。

• As 方法负责告诉系统：“我能被转换成哪些类型？”—— 通常用 reflect.TypeOf 或类型断言判断目标是否为本类型指针
• Is 方法决定“我是否等价于某个错误”—— 一般用于和自身其他实例或标准错误做语义比较
• 若错误被包装（如 fmt.Errorf("x: %w", myErr)），你的 As/Is 方法不会被自动调用；只有当它是错误链中某一层时才生效

type MyError struct{ Msg string }
func (e *MyError) Error() string { return e.Msg }
func (e *MyError) Is(target error) bool {
    _, ok := target.(*MyError)
    return ok // 简单示例：认为所有 *MyError 都相等
}
func (e *MyError) As(target interface{}) bool {
    if p, ok := target.(*MyError); ok {
        *p = *e
        return true
    }
    return false
}

以上就是《Golang错误判断：errors.Is与errors.As详解》的详细内容，更多关于的资料请关注golang学习网公众号！