errors.As用于提取错误链中特定类型，errors.Is用于判断错误链中是否存在目标错误；二者均依赖%w包装，不可用字符串拼接替代。
如何用 errors.As 和 errors.Is 做类型与值判断
Go 1.13 引入的错误包装机制让错误链变长，直接用 == 或 fmt.Sprintf 判断会失效。比如 os.Open 返回的 *os.PathError 被 fmt.Errorf("failed: %w", err) 包装后，原始类型就藏在底层了。
这时必须用 errors.As 提取具体错误类型，用 errors.Is 判断是否等于某个已知错误（如 io.EOF）：
var pathErr *os.PathError
if errors.As(err, &pathErr) {
log.Printf("path: %s, op: %s", pathErr.Path, pathErr.Op)
}
if errors.Is(err, io.EOF) {
// 处理读到末尾的情况
}
-
errors.As是深度查找，会顺着%w链一直向下，直到找到匹配类型或链结束 -
errors.Is比较的是错误链中任意一层是否==目标错误，不是字符串匹配 - 别对未包装的错误（如
fmt.Errorf("xxx")）用errors.As提取*os.PathError——类型根本不匹配，返回false
调试时怎么快速定位错误源头：加 runtime.Caller 和 fmt.Errorf("%w")
默认的 fmt.Errorf 不带堆栈，log.Print(err) 只输出消息，看不出在哪一层出的错。要保留上下文，得主动加调用信息或用支持堆栈的库（如 github.com/pkg/errors 已不推荐），但 Go 标准库从 1.17 起支持 errors.WithStack 的等效行为——靠 fmt.Errorf + %w + 自定义包装器。
更轻量的做法是手动注入位置：
立即学习“go语言免费学习笔记（深入）”；
func wrapErr(err error) error {
_, file, line, _ := runtime.Caller(1)
return fmt.Errorf("%s:%d %w", filepath.Base(file), line, err)
}
- 务必用
runtime.Caller(1)，而不是(0)，否则拿到的是wrapErr自己的行号 - 如果用了多个中间包装（比如 A → B → C → error），只在最外层加一次位置即可，否则日志冗余且易混淆
-
fmt.Errorf("%w")是关键：只有它才能被errors.Is/As正确解析；用%v或字符串拼接就断链了
为什么 log.Fatal 后看不到完整错误链
log.Fatal 默认只调用 err.Error()，丢弃所有包装信息和底层类型。你看到的只是最外层错误文本，无法用 errors.Is 判断，也无法提取原始错误字段。
- 替换方案：用
log.Fatalf("failed: %+v", err)，%+v是errors包提供的动词，会打印整条错误链和各层堆栈（如果有的话） - 若用了
github.com/pkg/errors等旧库，%+v还能显示文件/行号；标准库错误则只显示包装结构 - CI 或生产环境别依赖
log.Fatal做错误处理——它会直接退出进程，掩盖本可恢复的问题
调试真实 HTTP 服务时怎么把错误透传给客户端又不暴露敏感信息
开发时希望看到完整错误（含路径、SQL、变量名），上线后却不能把 os.PathError 的 Path 字段或数据库连接串打到响应体里。需要分环境做错误映射。
func handleError(w http.ResponseWriter, err error) {
if os.Getenv("ENV") == "dev" {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
var pgErr *pgconn.PgError
if errors.As(err, &pgErr) {
http.Error(w, "database error", http.StatusInternalServerError)
return
}
http.Error(w, "internal error", http.StatusInternalServerError)
}
- 永远不要直接
fmt.Sprint(err)返回给前端——可能泄露绝对路径、用户名、内部状态 - 对第三方错误（如
pgconn.PgError、redis.Nil）用errors.As单独识别，返回语义化提示 - 线上环境建议统一用
http.Error(w, "something went wrong", http.StatusInternalServerError)，具体日志走zap或log/slog记录完整错误链
错误链不是越深越好，包装太多会让 errors.Is 查找变慢，也增加调试认知负担。关键节点包装 1–2 层足够，重点是每层都提供不可替代的上下文。
