golang 中错误包装器用于将错误包裹在另一个错误中，以追踪错误的根源、添加额外信息和建立错误链。使用 errors.wrap 函数创建错误包装器，传播错误包装器可以累积错误信息。其优点包括错误追踪、丰富错误信息和错误嵌套，但要注意避免冗余、不包装标准错误。

GoLang 中错误包装器的用法

简介
错误包装器在 GoLang 中是一种将错误包裹在另一个错误中的机制。这有助于追踪错误的根源，并在错误的传播过程中添加额外的信息。

错误包装器创建
要创建错误包装器，可以使用 errors.Wrap 函数。此函数接受两个参数：

立即学习“go语言免费学习笔记（深入）”；

• 被包装的错误
• 描述包装错误的字符串

例如：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

package main

import (
    "errors"
    "fmt"
)

func main() {
    // 创建一个原始错误
    originalError := errors.New("random error")

    // 使用 Wrap() 创建一个错误包装器
    wrappedError := errors.Wrap(originalError, "wrapped error")

    // 打印出原始错误和包装错误
    fmt.Println(originalError)
    fmt.Println(wrappedError)
}

输出：

random error
wrapped error: random error

错误包装器的传播
错误包装器可以被传播给其他函数或中间件层，以逐层累积错误信息。

实战案例
考虑一个简单的函数，它从数据库中获取用户数据。该函数可能会返回一个 NotFoundError 错误，表示没有找到用户。我们可以使用错误包装器向该错误添加有关请求的额外上下文信息，例如：

// GetUser 获取指定用户名的用户数据
func GetUser(username string) (*User, error) {
    u, err := db.GetUserByUsername(username)
    if err != nil {
        return nil, errors.Wrap(err, fmt.Sprintf("GetUser: failed to get user with username %s", username))
    }

    return u, nil
}

优势
错误包装器有以下优势：

• 错误追踪：包装错误可以让你轻松地追踪错误的根源。
• 丰富的错误信息：它允许在错误传播过程中添加额外的上下文信息，使调试变得更加容易。
• 错误嵌套：错误可以成嵌套的结构嵌套，从而形成错误链。

注意事项
当使用错误包装器时，需要注意以下几点：

• 避免冗余：确保包装错误包含有价值的新信息，而不是重复原始错误。
• 不要包装标准错误：避免包装已经包含丰富信息的标准错误，如 io.EOF 或 context.Canceled。