如何在Go中实现错误包装_Go Error Wrap机制详解

go 1.13 引入错误包装机制，核心是 fmt.Errorf 的 %w 动词及 errors.Unwrap、errors.Is、errors.As 函数，支持错误链式判断与安全提取，提升可诊断性与可恢复性。

Go 1.13 引入了标准的错误包装（error wrapping）机制，核心是 fmt.Errorf 的 %w 动词和 errors 包中的一组函数（errors.Unwrap、errors.Is、errors.As）。它让错误能携带原始原因、支持链式判断，又不破坏原有语义。

用 %w 包装错误，保留原始错误链

使用 %w 是最常用、最推荐的包装方式。它会把传入的 error 作为“原因”嵌入新错误中，且该错误可被后续的 errors.Unwrap 提取。

示例：

Lovable

ai辅助编程工具

254

查看详情

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

这里 err 被完整包裹，调用方可用 errors.Is(err, os.ErrNotExist) 判断是否因文件不存在而失败，也可用 errors.As(err, &pathErr) 提取底层 *os.PathError。

errors.Is：跨多层判断错误是否由某个目标错误引起

errors.Is 会沿着 Unwrap() 链向上查找，只要某一层返回的错误与目标相等（或实现了 Is(error) 方法并返回 true），就返回 true。

常见用法：

• 检查是否是系统级错误：errors.Is(err, os.ErrPermission)
• 检查自定义错误类型：errors.Is(err, ErrTimeout)
• 兼容旧版字符串匹配逻辑（但更健壮）

errors.As：安全提取底层具体错误类型

当需要访问被包装错误的具体字段或方法时，用 errors.As。它会遍历整个错误链，找到第一个能赋值给目标类型的错误实例。

示例：

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

注意：传入的是指针地址（&pathErr），不是值；如果错误链里没有 *os.PathError，则返回 false，pathErr 保持零值。

errors.Unwrap：手动展开一层，慎用

errors.Unwrap 只解一层包装，返回内部错误（如果存在），否则返回 nil。一般不建议直接用它做业务逻辑判断——应优先用 Is 或 As。

典型场景：

• 调试时打印完整错误链：for err != nil { log.Print(err); err = errors.Unwrap(err) }
• 实现自定义错误类型的 Unwrap() 方法（需返回被包装的 error）

自定义包装错误示例：

type MyError struct {     Msg string     Err error } func (e *MyError) Error() string { return e.Msg } func (e *MyError) Unwrap() error { return e.Err }

这样它就能被 errors.Is 和 errors.As 正确识别。

基本上就这些。包装不是为了堆叠信息，而是为了可诊断、可判断、可恢复。用好 %w 和三个 errors 函数，Go 的错误处理就真正活起来了。