Golang如何使用errors.As和errors.Is_Golang errors.As errors.Is实践

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Golang如何使用errors.As和errors.Is_Golang errors.As errors.Is实践

2025-11-23

浏览次数：次

返回列表

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

golang如何使用errors.as和errors.is_golang errors.as errors.is实践

在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。