应使用 errors.as(err, &target) 判断并提取自定义错误，因其能穿透多层包装；target 必须为对应类型的非 nil 指针，否则 panic；errors.is 仅适用于哨兵错误，不适用于含字段的结构体错误。
如何用 errors.As 判断是否为特定自定义错误类型
Go 1.13+ 推荐用 errors.As 而非类型断言，因为它能穿透错误链（比如被 fmt.Errorf("wrap: %w", err) 包裹过的错误）。直接类型断言 err.(*MyError) 在错误被多层包装后会失败。
实操建议：
- 定义自定义错误结构体时，实现
Error()方法即可，无需额外接口 - 调用
errors.As(err, &target)，其中target是对应类型的指针变量 - 如果函数返回
true，说明err链中存在该类型，且已赋值到target
type ValidationError struct {
Field string
Msg string
}
func (e *ValidationError) Error() string {
return fmt.Sprintf("validation failed on %s: %s", e.Field, e.Msg)
}
// 使用
if errors.As(err, &ve) {
log.Printf("field %s failed: %s", ve.Field, ve.Msg)
}
为什么 errors.Is 不适用于带字段的自定义错误
errors.Is 用于判断是否等于某个“哨兵错误”（如 io.EOF），它依赖 Is(error) 方法或底层错误值相等。而带状态字段的自定义错误（如含 Code 或 Field 的结构体）无法用 errors.Is 精确匹配——它不比较字段内容，只看是否是同一个实例或实现了 Is 方法。
常见错误现象：用 errors.Is(err, &ValidationError{Field: "email"}) 总是返回 false，因为每次构造都是新地址。
立即学习“go语言免费学习笔记（深入）”；
正确做法：
- 对纯分类错误（如
ErrNotFound,ErrTimeout），用哨兵变量 +errors.Is - 对需提取字段的错误，必须用
errors.As获取结构体指针再访问字段 - 若真需要按字段做逻辑分支，可为自定义错误添加
Is(code int)方法并手动实现
在 HTTP handler 中统一提取和响应自定义错误
Web 服务中常需将不同层级的自定义错误转为 HTTP 状态码和 JSON 响应。关键点在于：不能只靠 errors.As 一次判断，要处理嵌套包装和优先级（例如，先找 *ValidationError，再找 *AuthError）。
实操建议：
- 定义错误处理顺序：越具体的错误类型越往前放，避免被更通用的类型（如
*AppError）提前捕获 - 用 switch + 多次
errors.As模拟“类型优先级匹配” - 避免在中间件里直接
json.Marshal(err)—— 结构体字段可能含敏感信息或未导出
func errorResponse(err error) (int, map[string]string) {
var ve *ValidationError
if errors.As(err, &ve) {
return http.StatusBadRequest, map[string]string{"error": ve.Error(), "field": ve.Field}
}
var ae *AuthError
if errors.As(err, &ae) {
return http.StatusUnauthorized, map[string]string{"error": ae.Error()}
}
return http.StatusInternalServerError, map[string]string{"error": "internal error"}
}
容易忽略的 panic 风险：As 的第二个参数必须是指针
errors.As 第二个参数传错类型会导致 panic：不是 nil 检查失败，而是直接 panic("errors.As: target must be a non-nil pointer to either a type that implements error or to any interface type")。这个错误信息明确但容易在快速编码时被忽略。
典型踩坑场景：
- 写成
errors.As(err, ve)（ve是值而非指针） - 写成
errors.As(err, &ValidationError{})（临时结构体地址，无法读取字段） - 声明了
var e ValidationError却传&e后忘记初始化字段，导致后续访问空值
最稳妥写法是始终声明目标变量为指针类型，并在 if 块内使用：var ve *ValidationError → if errors.As(err, &ve) → 此时 ve 已非 nil 且字段可用。
