Golang errors.As和Is使用详解

Go 1.13引入errors.Is和errors.As用于精准处理包装错误。1. errors.Is判断错误链中是否包含指定错误值，适用于匹配预定义错误；2. errors.As检查错误链中是否存在特定类型错误并赋值，适用于提取结构化错误信息。两者均支持递归遍历错误链，比传统比较更强大。使用%w包装错误可确保Is/As正常工作，建议在需上下文时包装错误，并用Is替代==、用As提取具体错误类型。

在Go语言中处理错误时，很多时候我们不仅需要知道发生了错误，还需要判断错误的具体类型或是否属于某类预定义错误。从Go 1.13开始，errors 包引入了 errors.Is 和 errors.As 两个函数，用于更精准地进行错误比较和类型断言。它们比传统的 == 或类型断言更强大，尤其是在处理包装错误（wrapped errors）时。

errors.Is：判断错误是否等于某个值

errors.Is(err, target) 用于判断错误链中是否存在某个特定的错误值。它会递归地检查被包装的错误，直到找到匹配项或结束。

适用于你已经有一个具体的错误变量，并希望判断当前错误是否“是”这个错误。

示例：

package main

import (
    "errors"
    "fmt"
)

var ErrNotFound = errors.New("not found")

func main() {
    err := fmt.Errorf("wrap: %w", ErrNotFound)
    
    // 判断 err 是否包含 ErrNotFound
    if errors.Is(err, ErrNotFound) {
        fmt.Println("error is 'not found'")
    }
}

输出：
error is 'not found'

即使 ErrNotFound 被包装了一层或多层，errors.Is 依然能正确识别。

errors.As：判断错误链中是否包含某个类型的错误

errors.As(err, &target) 用于判断错误链中是否有某个特定类型的错误（比如自定义错误结构体），并将该错误赋值给 target 指针。

当你需要访问错误的具体字段或方法时，这个函数非常有用。

示例：

package main

import (
    "errors"
    "fmt"
)

type ValidationError struct {
    Field string
    Msg   string
}

func (e *ValidationError) Error() string {
    return fmt.Sprintf("validation error on field '%s': %s", e.Field, e.Msg)
}

func main() {
    err := fmt.Errorf("outer error: %w", &ValidationError{Field: "email", Msg: "invalid format"})

    var ve *ValidationError
    if errors.As(err, &ve) {
        fmt.Printf("validation error on field: %s, message: %s\n", ve.Field, ve.Msg)
    }
}

输出：
validation error on field: email, message: invalid format

errors.As 遍历错误链，一旦发现可以转换为 *ValidationError 的错误，就将其赋值给 ve。

实际开发中的使用建议

• 用 errors.Is 替代对错误值的直接比较，尤其是当错误可能被包装时。
• 用 errors.As 提取带有上下文信息的结构化错误，比如数据库超时、权限拒绝、输入校验失败等。
• 在返回错误时，记得使用 %w 格式符包装原始错误，否则无法通过 Is/As 正确解析。
• 避免滥用包装，只在增加有意义上下文时才包装错误。

基本上就这些。合理使用 errors.Is 和 errors.As 可以让 Go 的错误处理更清晰、健壮，特别是在复杂调用链中定位问题时特别有用。