Go errors.As 如何提取嵌套错误中的自定义类型

我在把配置校验错误往上层返回时，最容易踩的坑不是忘记判断 err != nil，而是错误已经被包装，直接类型断言就拿不到原来的自定义字段。这个场景用 errors.As 处理：它会从当前错误开始沿着 Unwrap 错误链寻找可赋值给目标的类型，找到后把目标变量设为那个错误值。

目标错误是指针类型时，声明 var target *YourError，调用 errors.As(err, &target)。包装时使用 %w，匹配失败返回 false；不要把目标写成错误值本身，否则可能触发 panic。

errors.As 实际遍历的是哪一层错误

Go 的错误不是只能保存一段字符串。上层可以用 fmt.Errorf("读取配置失败: %w", err) 增加上下文，同时保留下层错误。errors.As 会先检查当前错误，再检查它通过 Unwrap() error 或 Unwrap() []error 暴露的后继错误。也就是说，外层描述可以变化，但内层的自定义类型仍然可被调用方识别。

这里要把 errors.Is 和 errors.As 分开：前者适合判断哨兵错误是否存在，后者适合拿到某个错误类型并读取它的字段。

目标变量为什么要写成指针的地址

下面的例子模拟配置校验失败。ValidationError 的 Error 方法用指针接收者实现，所以真正放进错误链的是 *ValidationError。调用 errors.As 时，第二个参数不是目标错误，而是“接收目标的指针”。

package main

import (
    "errors"
    "fmt"
)

// ValidationError 保存调用方真正需要的校验字段。
type ValidationError struct {
    Field  string
    Reason string
}

// Error 让 *ValidationError 满足 error 接口。
func (e *ValidationError) Error() string {
    return e.Field + ": " + e.Reason
}

// loadConfig 在增加上下文时用 %w 保留底层错误。
func loadConfig() error {
    cause := &ValidationError{Field: "port", Reason: "必须是 1 到 65535"}
    return fmt.Errorf("读取服务配置失败: %w", cause)
}

func main() {
    err := loadConfig()
    if err == nil {
        return
    }

    // 目标是 *ValidationError，所以传入它的地址 **ValidationError。
    var validationErr *ValidationError
    if errors.As(err, &validationErr) {
        fmt.Println("字段:", validationErr.Field)
        fmt.Println("原因:", validationErr.Reason)
        return
    }

    // 没有匹配类型时保留外层上下文，交给通用错误处理。
    fmt.Println("未识别的配置错误:", err)
}

看起来像“指针的指针”，其实只是因为目标错误本身是指针类型：validationErr 用来接收 *ValidationError，因此传入它的地址自然是 **ValidationError。匹配成功后，变量才会被写入；不要在匹配前读取它的字段。

把包装、权限和失败处理放进工作流

我通常把错误处理拆成三个阶段：底层创建带字段的错误，中间层只补充上下文，边界层用 errors.As 决定是否给用户返回可操作提示。中间层若改成 %v，字符串还在，但错误链断了，边界层就只能得到 false。

如果底层错误的类型属于实现细节，就不要为了让调用方匹配而无条件使用 %w；是否暴露可检查的错误属性，应当是包 API 的明确约定。对于多个错误组成的结果，标准库的 errors.Join 也会提供可遍历的错误集合，errors.As 仍然可以在其中寻找目标类型。

常见问题

errors.As 找不到自定义错误怎么办？

先确认上游用了 %w 或实现了 Unwrap，再确认目标变量的指针层级和错误类型完全一致。

errors.As 和类型断言有什么区别？

类型断言只检查当前接口值；errors.As 会继续检查错误链，适合跨越包装层提取类型。

匹配失败后可以继续使用目标变量吗？

不应依赖它。只有返回 true 时目标才代表找到的错误，返回 false 时走独立的通用处理分支。