Error.prototype.cause 不自动继承，需显式传入 { cause: err } 才构建错误链；否则 err.cause 为 undefined，深层原始错误丢失；应封装 getRootCause() 安全遍历，并注意兼容性与调试盲点。
为什么 Error.prototype.cause 在嵌套 throw 时经常“丢根”
直接抛出新错误（比如 throw new Error("处理失败")）会切断原始错误链，cause 不会自动继承。浏览器或 Node.js 只有在显式传入 cause 选项时才建立关联，不是默认行为。
常见错误现象：err.cause 是 undefined，即使上层捕获了原始错误并试图“包装”它；或者只保留了最近一层的 cause，深层原始错误丢失。
- 必须手动把捕获到的原始错误作为
cause传给新Error构造函数 - Node.js ≥16.9 和现代 Chrome/Firefox 支持该属性，但 Safari ≤16.6 不支持（需检查
err.cause !== undefined再访问） - 不要依赖
err.stack拼接来追溯——堆栈会覆盖，而cause是结构化引用
如何正确构造带 cause 的多层错误链
关键是在每一层 throw 前，用 new Error(message, { cause: originalErr }) 显式传递。注意：第二个参数是对象，不是单独的 cause 参数。
try {
riskyOperation(); // 可能抛出 TypeError: Cannot read property 'x' of null
} catch (err) {
// ✅ 正确：保留原始 err 为 cause
throw new Error("用户数据校验失败", { cause: err });
}
如果中间还有异步或函数调用，也必须延续这个模式：
async function validateUser(user) {
try {
await fetchProfile(user.id);
} catch (err) {
// ✅ 即使 err 已经带 cause，仍可继续链式传递
throw new Error("获取用户档案失败", { cause: err });
}
}
- 可以安全地对已有
err.cause再包装：新错误的cause就是旧错误，形成链表 - 不要写成
new Error("xxx", err)—— 这会被当作options的误用，err不会被识别为 cause - 若需附加上下文字段（如
code,details），可扩展 error 实例，但cause必须走标准构造参数
怎么安全地读取最底层原始错误（避免无限递归或 cause 为空）
不能无条件 err.cause.cause.cause 往下钻——cause 可能为 null、undefined，或指向非 Error 实例（比如字符串、普通对象）。
推荐封装一个提取根因的工具函数：
function getRootCause(err) {
let current = err;
while (current && typeof current === 'object' && 'cause' in current && current.cause) {
current = current.cause;
}
return current;
}
- 每次循环前检查
current.cause是否存在且非 null/undefined - 不假设
cause一定是Error实例——有些库或手写错误可能设成字符串，这时应停止遍历 - 日志中打印根因时，建议同时输出
getRootCause(err).stack和err.stack对比，确认链是否完整
和 error.cause 相关的兼容性与调试盲点
开发时容易忽略两点：一是构建工具（如 Webpack/Babel）可能把 new Error(msg, { cause }) 编译掉或降级；二是某些测试框架（如 Jest）的错误断言不自动展开 cause 链。
- 在 Node.js 中启用
--throw-deprecation或使用node --trace-warnings可暴露未被处理的 cause 链断裂警告 - Vite / esbuild 默认支持该语法，但若目标
target设为es2019以下，需手动 polyfill（不推荐，改 target 更稳妥） - Chrome DevTools 的 “Console” 面板会显示
cause字段（点击展开），但“Sources” 断点停住时，err.cause可能未初始化完成——要等catch块执行完才可查
最常被忽略的是：即使你每层都写了 { cause: err }，如果某次 throw 发生在 finally 块里，且没捕获当前作用域的 err，就会覆盖整个链。这种地方的错误永远找不到根因。
