4. 错误码断言基础：errors.Is、errors.As、类型断言、错误链遍历

在 Go 语言中，错误处理不仅仅是检查 err != nil。当错误被多层包装（wrapping）后，如何准确判断底层错误类型或提取特定错误码，成为分布式系统与发布回滚场景中的关键能力。本章深入剖析 Go 1.13 引入的错误链断言机制，涵盖 errors.Is、errors.As、原生类型断言以及手动遍历错误链的实战用法。

4.1 错误链与包装模型

Go 通过 fmt.Errorf("context: %w", err) 或自定义 Wrap 方法构建错误链。每个包装层都持有对下一层错误的引用，形成单向链表结构。断言操作的核心就是沿着这条链逐层匹配。

4.2 errors.Is：值相等性断言

errors.Is(err, target) 用于判断错误链中是否存在与 target 相等的错误值。它通过 == 比较或调用目标类型的 Is(error) bool 方法实现。适用于检查特定哨兵错误（sentinel error）是否出现在链中。

// 定义哨兵错误
var ErrNotFound = errors.New("record not found")
var ErrTimeout = errors.New("request timeout")

// 包装错误
err := fmt.Errorf("query failed: %w", ErrNotFound)

// 断言
if errors.Is(err, ErrNotFound) {
    fmt.Println("匹配到 ErrNotFound") // 输出
}
if errors.Is(err, ErrTimeout) {
    fmt.Println("匹配到 ErrTimeout") // 不输出
}

4.3 errors.As：类型匹配与提取

errors.As(err, target) 用于在错误链中查找第一个可以赋值给 target 的错误实例。它通过类型断言或调用目标类型的 As(interface{}) bool 方法实现。适用于提取携带额外上下文（如错误码、状态码）的结构化错误。

// 自定义错误类型，携带 HTTP 状态码
type HTTPError struct {
    Code    int
    Message string
    Err     error
}

func (e *HTTPError) Error() string {
    return fmt.Sprintf("HTTP %d: %s", e.Code, e.Message)
}
func (e *HTTPError) Unwrap() error {
    return e.Err
}

// 使用
baseErr := &HTTPError{Code: 503, Message: "Service Unavailable", Err: nil}
wrappedErr := fmt.Errorf("upstream failure: %w", baseErr)

var target *HTTPError
if errors.As(wrappedErr, &target) {
    fmt.Printf("提取到 HTTP 错误码: %d\n", target.Code) // 输出 503
}

4.4 原生类型断言

当错误链只有一层或明确知道错误类型时，可直接使用 Go 类型断言语法 err.(*MyError)。这种方式不遍历链，仅断言当前层。若错误已被包装，断言会失败。

err := &HTTPError{Code: 400, Message: "Bad Request"}
if e, ok := err.(*HTTPError); ok {
    fmt.Println(e.Code) // 直接提取
}

// 如果 err 被包装，则断言失败
wrapped := fmt.Errorf("wrapped: %w", err)
if _, ok := wrapped.(*HTTPError); !ok {
    fmt.Println("类型断言失败，需要使用 errors.As")
}

4.5 手动遍历错误链

Go 1.13 提供了 errors.Unwrap(err) error 函数，返回错误链的下一层。结合循环可手动遍历整条链。适用于需要记录完整错误路径或自定义匹配逻辑的场景。

func traverseChain(err error) {
    for err != nil {
        fmt.Println("层级:", err.Error())
        err = errors.Unwrap(err)
    }
}

// 示例
root := errors.New("disk full")
mid := fmt.Errorf("write failed: %w", root)
top := fmt.Errorf("save document: %w", mid)

traverseChain(top)
// 输出:
// 层级: save document: write failed: disk full
// 层级: write failed: disk full
// 层级: disk full

4.6 实战对比：发布回滚中的断言选择

在发布回滚系统中，错误码断言直接影响回滚决策的准确性和性能。下表总结了不同场景下的推荐方法：