怎样用 Error.prototype.cause 属性在多层级异常捕获中保留最原始的报错诱因数据

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，就会覆盖整个链。这种地方的错误永远找不到根因。