Go中实现错误链的核心是用%w包装错误以保留因果关系，配合errors.Is判断原始错误、errors.As提取具体类型，避免字符串拼接或errors.New破坏链。
在 Go 中实现错误链（error chaining）并追踪原始错误，核心是利用 Go 1.13+ 引入的 errors.Is、errors.As 和 errors.Unwrap，配合自定义错误包装或标准库的 fmt.Errorf 带 %w 动词。关键不是“记录调用栈”，而是“保留错误因果关系”，让上层能准确识别、提取和响应原始错误。
使用 %w 包装错误以构建可展开的错误链
每次在函数中捕获错误并返回新错误时，用 %w 显式包装，而不是拼接字符串或用 %s。这样该错误就实现了 Unwrap() error 方法，形成链式结构。
例如：
func readFile(path string) error {
data, err := os.ReadFile(path)
if err != nil {
return fmt.Errorf("failed to read config file %q: %w", path, err) // ✅ 包装
}
// ...
return nil
}
func loadConfig() error {
if err := readFile("/etc/app/config.yaml"); err != nil {
return fmt.Errorf("config initialization failed: %w", err) // ✅ 继续包装
}
return nil
}
此时 loadConfig() 返回的错误，可通过多次 errors.Unwrap 回溯到最底层的 os.PathError。
立即学习“go语言免费学习笔记（深入）”；
用 errors.Is 判断是否为特定原始错误类型
当需要根据原始错误做决策（如重试、忽略、转换），不要用字符串匹配，而用 errors.Is —— 它会沿整个错误链向上检查，直到找到匹配或链结束。
常见用法：
-
判断是否为系统级文件不存在错误：
errors.Is(err, fs.ErrNotExist) -
判断是否为网络超时：
errors.Is(err, context.DeadlineExceeded) -
判断是否由某个自定义错误触发：
errors.Is(err, ErrValidationFailed)
用 errors.As 提取原始错误的具体类型
若需访问原始错误的字段或方法（如获取 os.PathError.Path 或 net.OpError.Addr），用 errors.As 安全地向下类型断言。
示例：
if err := loadConfig(); err != nil {
var pathErr *fs.PathError
if errors.As(err, &pathErr) {
log.Printf("File access failed on path: %s", pathErr.Path)
}
var netErr *net.OpError
if errors.As(err, &netErr) && netErr.Timeout() {
log.Print("Network operation timed out")
}
}
errors.As 会遍历整个错误链，只要某一层是目标类型，即成功赋值。
避免破坏错误链的常见错误
以下做法会切断错误链，导致原始错误丢失：
-
用
fmt.Sprintf或fmt.Errorf("%s", err)替代%w—— 这生成的是纯字符串错误，无Unwrap -
在中间层用
errors.New重新构造错误 —— 完全丢弃原始错误上下文 -
对已包装的错误再次用
%w包装但未校验是否已含原始错误（一般无需担心，%w是安全的）
若必须添加上下文又不确定是否已包装，可先 errors.Unwrap 检查，但更推荐统一约定：所有中间层都用 %w，顶层按需处理。
