Go中errors.Is与errors.As使用解析

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Go中errors.Is与errors.As用法详解》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

errors.Is用于判断错误链中是否包含指定错误，errors.As用于提取错误链中特定类型的错误。示例显示ErrNotFound被包装后仍可被Is识别，而As能成功提取*ValidationError类型并获取字段信息。使用%w包装错误可确保错误链完整，Is和As可穿透多层；建议公共错误用sentinel值，上下文错误用结构体，避免对非导出类型使用As。掌握二者可提升错误处理安全性与清晰度，尤其适用于大型项目或库开发。

在Go 1.13之后，标准库引入了errors.Is和errors.As，用来更方便地处理错误判断和类型断言。这两个函数解决了以往用==或type assertion判断错误时的局限性，尤其是在包装（wrap）错误的场景下。

errors.Is：判断是否是某个特定错误

当你需要判断一个错误是否等于某个已知的错误值时，使用errors.Is。它会递归地比较错误链中的每一个底层错误，而不仅仅是表面值。

常见于使用errors.New定义的 sentinel 错误（即预定义的错误变量）。

package main

import (
    "errors"
    "fmt"
)

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

func main() {
    err := fmt.Errorf("wrap: %w", ErrNotFound)
    
    // 使用 errors.Is 判断
    if errors.Is(err, ErrNotFound) {
        fmt.Println("error is ErrNotFound")
    }
}

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

errors.As：提取特定类型的错误

当你需要从一个错误中提取某个具体类型的错误（比如自定义结构体）时，使用errors.As。它会在错误链中查找能赋值给目标类型的错误，并将指针赋值给传入的变量。

package main

import (
    "errors"
    "fmt"
)

type ValidationError struct {
    Field string
    Msg   string
}

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

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

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

errors.As会遍历错误链，尝试把每个底层错误赋值给ve，一旦成功就返回true。

实际使用建议

• 定义公共错误时，用var ErrXXX = errors.New("...")，以便其他包使用errors.Is判断。
• 需要携带上下文信息的错误，定义为结构体并实现Error()方法，用errors.As提取。
• 包装错误时一定要使用%w动词，否则错误链断裂，Is和As无法穿透。
• 不要对非导出错误类型使用errors.As，避免耦合。

基本上就这些。掌握errors.Is和errors.As，能让错误处理更安全、清晰，尤其在大型项目或库开发中尤为重要。

本篇关于《Go中errors.Is与errors.As使用解析》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！