Go语言错误处理技巧与实践

本篇文章给大家分享《Go语言错误包装与处理详解》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

Go 1.13起通过%w包装错误可保留原始信息，使用errors.Is和errors.As能语义化解包判断，自定义错误需实现Unwrap方法以支持解包，提升错误处理精准度。

在Go语言中，错误处理是程序健壮性的重要组成部分。从Go 1.13开始，标准库引入了错误包装（error wrapping）机制，使得开发者可以在保留原始错误信息的同时添加上下文，也支持后续对错误进行解包以检查底层原因。以下是实现错误包装与解包的实用方法。

错误包装：使用 %w 格式动词

通过 fmt.Errorf 配合 %w 动词，可以将一个已有的错误包装进新错误中，同时保留其原始结构，便于后续分析。

示例：

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

这样生成的错误可以通过 errors.Unwrap 提取原始错误。注意，只有使用 %w 才会触发包装行为，%v 或 %s 不具备此功能。

错误解包：使用 errors.Is 和 errors.As

直接调用 errors.Unwrap(err) 可以获取被包装的下一层错误，但更推荐使用 errors.Is 和 errors.As 进行语义化判断。

• errors.Is(err, target)：判断错误链中是否存在某个特定错误（如 os.ErrNotExist）
• errors.As(err, &target)：判断错误链中是否包含指定类型的错误，并赋值给目标变量

示例：

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

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

自定义错误类型支持包装

如果需要定义自己的错误类型并支持包装，只需在结构体中嵌入一个 error 字段，并实现 Error() 方法。

示例：

type MyError struct {
    Msg string
    Err error // 嵌入原始错误
}

func (e *MyError) Error() string {
    return e.Msg + ": " + e.Err.Error()
}

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

这样构造的错误可以被 errors.Is 和 errors.As 正常处理，Unwrap 方法是解包的关键。

基本上就这些。合理使用包装能让错误携带更多上下文，而正确解包有助于精准处理异常情况。关键是理解 %w 的作用以及优先使用 Is/As 而非直接比较错误字符串。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。