如何在Golang中实现错误上下文信息

使用fmt.Errorf配合%w包装错误并添加上下文，通过errors.Is和errors.As判断和提取底层错误，自定义错误类型可携带更多上下文信息，需堆栈时引入github.com/pkg/errors。

在Golang中实现错误上下文信息，核心是让调用方能清楚知道错误发生的根本原因以及它在整个调用链中的位置。Go 1.13之后引入的 errors 包增强功能（如fmt.Errorf 的 %w 动词、errors.Is 和 errors.As）使得添加上下文同时保留原始错误成为可能。

使用 fmt.Errorf 添加上下文

最常用的方式是在函数返回错误前，通过 fmt.Errorf 使用 %w 包装原始错误，同时附加当前层的上下文信息。

示例：

ASP.NET 4.0电子商城

在现实生活中的购物过程，购物者需要先到商场，找到指定的产品柜台下，查看产品实体以及标价信息，如果产品合适，就将该产品放到购物车中，到收款处付款结算。电子商务网站通过虚拟网页的形式在计算机上摸拟了整个过程，首先电子商务设计人员将产品信息分类显示在网页上，用户查看网页上的产品信息，当用户看到了中意的产品后，可以将该产品添加到购物车，最后使用网上支付工具进行结算，而货物将由公司通过快递等方式发送给购物者

下载

func readFile(path string) ([]byte, error) {
    data, err := os.ReadFile(path)
    if err != nil {
        return nil, fmt.Errorf("读取文件失败: %s: %w", path, err)
    }
    return data, nil
}

func processConfig() error {
    _, err := readFile("config.json")
    if err != nil {
        return fmt.Errorf("处理配置文件时出错: %w", err)
    }
    return nil
}

提取和判断包装的错误

使用 errors.Is 判断是否包含某个特定错误，errors.As 提取特定类型的错误以便访问其字段。

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

示例：

if errors.Is(err, os.ErrNotExist) {
    log.Println("文件不存在")
}

var pathErr *os.PathError
if errors.As(err, &pathErr) {
    log.Printf("路径错误: %v", pathErr.Path)
}

自定义错误类型携带上下文

当需要更丰富的上下文（如操作名、时间、用户ID等），可以定义自己的错误类型。

示例：

type MyError struct {
    Op      string
    Message string
    Err     error
}

func (e *MyError) Error() string {
    return fmt.Sprintf("%s: %s: %v", e.Op, e.Message, e.Err)
}

func (e *MyError) Unwrap() error {
    return e.Err
}

// 使用
return &MyError{Op: "readFile", Message: "failed to open", Err: err}

打印带堆栈的错误信息

标准库不自带堆栈追踪，但可通过第三方库如 github.com/pkg/errors 实现，它提供 errors.Wrap 和 errors.WithStack。

示例：

import "github.com/pkg/errors"

_, err := someFunc()
if err != nil {
    return errors.Wrap(err, "someFunc failed")
}

// 输出堆栈
fmt.Printf("%+v\n", err)