errors.Is总返回false的主因是错误链断裂：某层用fmt.Errorf("…%v", err)未用%w，导致Unwrap()缺失；errors.As失败多因传值而非传指针；errors.Unwrap仅解一层且需判空；自定义错误Unwrap()须语义正确、非伪造。
errors.Is 为什么总返回 false
最常见的现象是：errors.Is(err, io.EOF) 返回 false，但你确认最底层错误确实是 io.EOF。根本原因不是“没包对”，而是中间某一层用了 fmt.Errorf("read failed: %v", err) 或字符串拼接，导致错误链断裂。
只要有一层没用 %w，errors.Is 就无法穿透过去——它只信任实现了 Unwrap() error 的错误节点，且会逐层调用直到匹配或返回 nil。
- 检查所有
fmt.Errorf调用：必须用%w，不能用%v、%s或+拼接 - 第三方库返回的错误若没实现
Unwrap()，它就是链的终点，errors.Is不会继续往下查 -
errors.Is(err, someErr)中的someErr必须是同一个实例（比如fs.ErrNotExist），不能是新构造的errors.New("not exist")
errors.As 提取具体错误类型失败的典型原因
errors.As 用于从错误链中提取某个具体类型的指针值，比如 *os.PathError，但它失败往往不是因为类型不对，而是调用方式错了。
关键点：第二个参数必须是指针的地址，且目标类型必须能被链中某一层直接赋值。
立即学习“go语言免费学习笔记（深入）”；
- 写法错误：
var pe os.PathError; errors.As(err, &pe)→ 永远失败，因为os.PathError是值类型，而errors.As需要接收指针类型 - 正确写法：
var pe *os.PathError; errors.As(err, &pe)→ 成功时pe指向链中第一个匹配的*os.PathError - 自定义错误类型若想被
errors.As正确识别，必须让它的指针类型满足目标接口，比如实现error接口的同时，确保字段可导出、结构体可寻址 - 如果错误链中有多个
*os.PathError，errors.As只返回第一个，不会继续找
手动调用 errors.Unwrap 容易踩的坑
errors.Unwrap 只解一层，这是设计使然，不是 bug。但很多人误以为它能递归展开整个链，结果写出逻辑漏洞。
常见问题包括空指针 panic、跳过中间层、陷入死循环。
- 每次调用后必须判空：
for err != nil { err = errors.Unwrap(err) }，否则下一轮errors.Unwrap(nil)会 panic -
errors.Unwrap对不支持包装的错误（如errors.New构造的）返回nil，不代表“没错误”，只是“不可展开” - 不要把
errors.Unwrap当成errors.Is的替代品：手写循环容易漏掉某层，也缺乏环检测，遇到自引用错误（A.Wrap(B), B.Wrap(A)）会卡死 - 日志里慎用
%+v打印错误链——它依赖fmt.Formatter实现，标准库只对fmt.Errorf链做了支持；自定义错误没实现该接口时，%+v只输出当前层
自定义错误类型如何真正接入错误链
不是所有实现了 Unwrap() error 的类型都能被 errors.Is 或 errors.As 正确处理。接入错误链的关键是“语义一致”：你返回的错误必须是真实包裹关系，不能是伪造或懒加载占位符。
比如下面这个类型看似合法，实则断链：
type MyErr struct {
msg string
err error // 真实包裹的错误
}
func (e *MyErr) Error() string { return e.msg }
func (e *MyErr) Unwrap() error { return e.err } // ✅ 正确：原样返回保存的 err
- 如果
e.err是nil，Unwrap()返回nil是合法的，但会导致上层errors.Is直接终止遍历，跳过你的类型 - 如果错误确实包裹了另一个错误，
Unwrap()必须返回那个错误变量，哪怕它是nil（Go 允许error类型为nil） - 返回硬编码错误（如
return io.ErrUnexpectedEOF）会误导链遍历逻辑，让errors.Is在你这层就匹配成功，掩盖真实源头 - 构造时没保存原始错误，或
Unwrap()返回临时构造的新错误，都会让错误链失去上下文连贯性
错误链不是为了套娃，而是为了在判断和提取时保持路径可信。最容易被忽略的是：每层 Unwrap() 的语义责任——它不是“有没有错误”，而是“我是否明确包裹了这个错误”。一旦语义错位，整条链就变成不可靠的装饰品。
