在Golang的错误处理体系中，错误链是指将一个错误嵌套到另一个错误内部，形成多层错误嵌套的结构，这种设计可以让上层错误携带更多上下文信息，同时保留原始错误的核心内容。标准库errors包提供了一系列方法支持错误链的构建和追踪，下面详细介绍具体的实现方式。
错误链的基础概念
错误链的核心是通过error接口的扩展方法实现嵌套，Golang中如果一个错误类型实现了Unwrap() error方法，就说明这个错误可以被解包，从而获取它内部嵌套的错误。常见的错误包装方式是通过fmt.Errorf配合%w占位符，或者使用errors包的Wrap相关方法。
errors包核心方法介绍
1. 错误包装方法
errors包提供了Wrap和Wrapf方法用于包装错误，将原始错误嵌套到新的错误中，同时可以添加上下文信息：
package main
import (
"errors"
"fmt"
)
func readFile() error {
// 模拟原始错误
originalErr := errors.New("文件不存在")
// 包装错误，添加上下文
return fmt.Errorf("读取文件失败: %w", originalErr)
}
func main() {
err := readFile()
fmt.Println(err) // 输出：读取文件失败: 文件不存在
}
2. Unwrap方法
errors.Unwrap(err error) error方法用于获取错误链中当前错误的下一个错误，如果当前错误没有实现Unwrap方法，会返回nil：
package main
import (
"errors"
"fmt"
)
func main() {
originalErr := errors.New("原始错误")
wrappedErr := fmt.Errorf("上层错误: %w", originalErr)
// 解包获取原始错误
unwrappedErr := errors.Unwrap(wrappedErr)
fmt.Println(unwrappedErr) // 输出：原始错误
fmt.Println(unwrappedErr == originalErr) // 输出：true
}
3. Is方法
errors.Is(err, target error) bool方法用于判断错误链中是否存在和目标错误匹配的错误，它会自动遍历整个错误链进行比对：
package main
import (
"errors"
"fmt"
)
func main() {
originalErr := errors.New("连接超时")
wrappedErr := fmt.Errorf("请求失败: %w", originalErr)
// 判断错误链中是否有连接超时错误
if errors.Is(wrappedErr, originalErr) {
fmt.Println("捕获到连接超时错误")
}
}
4. As方法
errors.As(err error, target interface{}) bool方法用于将错误链中的错误转换为指定类型的错误，方便获取自定义错误类型的字段：
package main
import (
"errors"
"fmt"
)
// 自定义错误类型
type MyError struct {
Code int
Message string
}
func (e *MyError) Error() string {
return fmt.Sprintf("错误码:%d, 信息:%s", e.Code, e.Message)
}
func main() {
originalErr := &MyError{Code: 500, Message: "服务异常"}
wrappedErr := fmt.Errorf("操作失败: %w", originalErr)
var myErr *MyError
if errors.As(wrappedErr, &myErr) {
fmt.Printf("获取到自定义错误，错误码:%dn", myErr.Code) // 输出：获取到自定义错误，错误码:500
}
}
完整错误链追踪示例
下面通过一个多层嵌套的错误链示例，演示完整的追踪过程：
package main
import (
"errors"
"fmt"
)
func step1() error {
return errors.New("步骤1执行失败")
}
func step2() error {
err := step1()
if err != nil {
return fmt.Errorf("步骤2调用步骤1失败: %w", err)
}
return nil
}
func step3() error {
err := step2()
if err != nil {
return fmt.Errorf("步骤3调用步骤2失败: %w", err)
}
return nil
}
func main() {
err := step3()
if err != nil {
fmt.Println("顶层错误:", err)
// 遍历错误链
currentErr := err
for currentErr != nil {
fmt.Println("当前错误:", currentErr)
currentErr = errors.Unwrap(currentErr)
}
}
}
上述代码执行后会输出三层错误，分别是步骤3、步骤2、步骤1对应的错误，通过遍历Unwrap的结果就可以完整追踪整个错误链的来源。
注意事项
- 使用
%w占位符包装错误时，只能用于fmt.Errorf，不能用在fmt.Sprintf中，否则会返回字符串而不是错误类型。 errors.Is和errors.As会自动遍历错误链，不需要手动调用Unwrap，比直接比对错误更可靠。- 自定义错误类型如果需要支持错误链，需要实现
Unwrap() error方法，返回内部嵌套的错误。
Golangerrors包错误链追踪unwraperror_wrapping修改时间：2026-07-18 14:57:29