Golang错误包装技巧与实践方法

使用fmt.Errorf配合%w可包装错误并保留原始信息，通过errors.Unwrap、Is和As能提取或判断错误链中的具体错误，支持多层上下文添加与精准处理。

在Go语言中，错误包装（Error Wrapping）是一种将底层错误信息保留并附加更多上下文的方式，使得调用者既能知道发生了什么，也能了解错误发生的路径。从Go 1.13开始，标准库引入了对错误包装的支持，主要通过 fmt.Errorf 配合 %w 动词来实现。

使用 fmt.Errorf 和 %w 进行错误包装

当你需要在原有错误基础上添加上下文时，可以使用 fmt.Errorf 并配合 %w 动词来包装错误。

例如：

if err != nil {
    return fmt.Errorf("failed to read config file: %w", err)
}

这里的 %w 表示将原始错误包装进去。这样返回的错误就包含了原始错误，并可以通过 errors.Unwrap 提取。

提取和检查包装的错误

要判断一个错误是否是由特定类型引起的，即使它被包装了多次，可以使用 errors.Is 和 errors.As。

• errors.Is(err, target)：判断错误链中是否有某个特定错误（比如 os.ErrNotExist）。
• errors.As(err, &target)：判断错误链中是否包含某个特定类型的错误，可用于提取具体错误值。

示例：

if errors.Is(err, os.ErrNotExist) {
    log.Println("file does not exist")
}

var pathErr *os.PathError
if errors.As(err, &pathErr) {
    log.Printf("path error: %v", pathErr.Path)
}

多层包装与错误链

错误可以被多次包装，形成一条“错误链”。每一层都可以添加上下文，而原始错误仍然可访问。

例如：

func readFile(path string) error {
    data, err := os.ReadFile(path)
    if err != nil {
        return fmt.Errorf("reading %s: %w", path, err)
    }
    // 处理数据...
    return process(data)
}

func process(data []byte) error {
    // 模拟处理失败
    return fmt.Errorf("processing failed: %w", io.ErrUnexpectedEOF)
}

最终的错误信息会显示完整的上下文路径，同时保留原始错误，便于调试和处理。

基本上就这些。使用 %w 包装、Is 判断等价性、As 提取具体类型，是现代Go错误处理的标准做法。注意不要滥用包装，避免重复添加无意义的上下文。