Golang错误上下文封装方法详解

错误包装的常见方法有使用%w、第三方库pkg/errors和自定义错误类型。1. 使用%w可简洁包装错误并支持Unwrap、Is和As操作，但仅限单错误包装；2. pkg/errors提供Wrap和WithMessage方法增强堆栈信息，适合调试需求；3. 自定义错误类型灵活封装额外信息如操作类型，需实现Error和Unwrap方法。判断错误时常用errors.Is()匹配特定值，errors.As()提取具体类型，并自动遍历错误链。选择合适方式能提升错误处理清晰度与排查效率。

在写 Go 项目时，我们经常会遇到需要把底层错误“包装”起来的情况。比如调用数据库失败、网络请求出错，这时候如果不加处理直接返回原始错误，上层逻辑很难知道到底出了什么问题。所以，我们需要一种方式，既能保留原始错误信息，又能加上当前上下文的描述，这样排查问题更方便。

Go 1.13 引入了 errors.Unwrap 和 %w 的方式来支持错误包装，而后续的版本也在不断完善相关功能。下面我们就来看看几种常见且实用的方法。

错误包装的基本做法：使用 %w

最简单也最常见的错误包装方式，就是在 fmt.Errorf 中使用 %w 来封装底层错误：

if err := doSomething(); err != nil {
    return fmt.Errorf("doSomething failed: %w", err)
}

这样做之后，你可以用 errors.Unwrap() 或者 errors.Is()、errors.As() 来判断原始错误类型。比如：

if errors.Is(err, os.ErrNotExist) {
    // 处理文件不存在的情况
}

这种方式的优点是简洁明了，适合大多数场景。但它的缺点也很明显：只能包装一个错误，而且每次包装都要手动加一句。

使用 github.com/pkg/errors 增强堆栈信息

虽然标准库已经支持了错误包装，但它默认不会记录堆栈信息。如果你希望调试时能知道错误是在哪一层发生的，可以考虑引入第三方库，比如 pkg/errors。

它提供了两个常用方法：

• Wrap(err, "message")：添加上下文信息并保留原错误
• WithMessage(err, "message")：只附加信息不记录堆栈（轻量）

例如：

if err := doSomething(); err != nil {
    return errors.Wrap(err, "failed to do something")
}

打印错误时可以用 errors.Print(err) 查看完整的堆栈路径，对调试非常有帮助。

不过要注意的是，这个库是非标准的，如果你希望保持代码干净或者依赖尽量少，可以选择下一节提到的方式。

自定义错误类型实现上下文封装

有时候你可能希望封装更多信息，比如错误码、操作类型、重试建议等。这时候可以自定义错误类型：

type MyError struct {
    Op  string
    Err error
}

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

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

使用的时候：

if err := doSomething(); err != nil {
    return &MyError{Op: "read config", Err: err}
}

这种方式灵活性很高，适合大型项目或中间件开发。但也要注意别过度设计，除非你确实需要这些额外的信息。

判断和提取错误：Is 和 As 的使用技巧

当你层层包装错误后，想判断某个错误是否是特定类型或者具体值，就可以用 errors.Is() 和 errors.As()。

举个例子：

if errors.Is(err, io.EOF) {
    // 处理 EOF
}

var netErr net.Error
if errors.As(err, &netErr) && netErr.Timeout() {
    // 处理超时
}

这两个函数会自动遍历整个错误链，找到匹配的部分。这是比直接比较错误更可靠的做法。

需要注意的一点是，如果你想让你的自定义错误也能被识别，必须实现 Unwrap() 方法。

基本上就这些。Go 的错误处理机制虽然不像其他语言那样有异常捕获，但通过包装和上下文传递，其实也可以做到清晰可控。关键是要根据项目规模选择合适的封装方式，既不要过于复杂，也不要忽略上下文信息。