Go语言中通过fmt.Errorf使用%w包装错误可保留原始错误并添加上下文，结合errors.Is、errors.As和errors.Unwrap实现链式判断与提取，自定义错误类型可携带时间戳、操作类型等信息，提升错误的可追溯性与日志可读性。
在 Go 语言中，error 是一个接口类型，简单但功能有限。默认情况下，error 只包含错误信息字符串，缺乏调用栈、上下文或链式追溯能力。在实际开发中，仅靠 errors.New 或 fmt.Errorf 很难快速定位问题根源。为了让 error 携带更多上下文，提升调试和日志追踪效率，我们可以采用多种技巧增强 error 的表达能力。
使用 fmt.Errorf 包装错误并添加上下文
从 Go 1.13 开始，fmt.Errorf 支持使用 %w 动词来包装错误（wrap error），这不仅能保留原始错误，还能附加当前上下文。
- 使用
%v、%s等格式化动词只能生成新错误，原始错误无法通过errors.Unwrap恢复。 - 使用
%w包装后，可通过errors.Unwrap、errors.Is和errors.As进行链式判断和提取。
示例：
if err != nil {
return fmt.Errorf("处理用户数据失败: %w", err)
}
这样日志中能看到“处理用户数据失败: EOF”，同时仍能追溯到原始的 io.EOF 错误。
立即学习“go语言免费学习笔记（深入）”；
利用 errors 包进行错误判断与提取
Go 标准库 errors 提供了三个关键函数用于处理包装后的 error 链：
-
errors.Is(err, target)：判断 error 链中是否包含指定目标错误（如os.ErrNotExist）。 -
errors.As(err, &target)：尝试将 error 链中的某个错误赋值给特定类型的变量（如自定义错误结构体）。 -
errors.Unwrap(err)：获取被包装的下一层错误（适用于单层解包）。
示例：
if errors.Is(err, io.EOF) {
log.Println("读取文件时遇到意外结束")
}
var pathError *os.PathError
if errors.As(err, &pathError) {
log.Printf("路径错误: %v", pathError.Path)
}
构建自定义错误类型携带丰富上下文
当标准包装不够用时，可以定义自己的错误类型，加入时间戳、请求 ID、操作类型等信息。
示例：
type MyError struct {
Op string
Msg string
Err error
Time time.Time
}
func (e *MyError) Error() string {
return fmt.Sprintf("[%s] %s: %s (%v)", e.Time.Format(time.Stamp), e.Op, e.Msg, e.Err)
}
func (e *MyError) Unwrap() error {
return e.Err
}
使用方式：
return &MyError{
Op: "fetch_user",
Msg: "用户不存在",
Err: sql.ErrNoRows,
Time: time.Now(),
}
这种结构便于日志系统提取字段，也支持错误链分析。
结合第三方库增强错误追踪能力
虽然标准库已足够应对多数场景，但在大型项目中，可考虑引入第三方库进一步增强能力：
-
github.com/pkg/errors：提供
Wrap、WithMessage、WithStack等便捷函数，自动记录堆栈信息。 -
使用建议：若项目允许依赖，可在关键路径使用
errors.WithMessage(err, "上下文")或errors.Wrap(err, "操作描述")，调试时调用errors.Cause获取根因，fmt.Printf("%+v", err)输出完整堆栈。
注意：该库在 Go 1.13+ 后部分功能已被标准库替代，需权衡是否引入。
基本上就这些方法。合理使用错误包装、上下文添加和类型设计，能让 Go 的 error 更具可读性和可维护性，尤其在多层调用和分布式系统中尤为重要。关键是保持一致性：团队内统一使用一种模式，避免混用导致排查困难。
