核心是保持执行链路的上下文可追溯性，需手动透传唯一traceId、显式携带上下文、统一错误包装与日志标准化，借助AsyncLocalStorage（Node）或参数透传（浏览器）贯穿异步链路，并在每条日志和错误中强制注入traceId。
在 JavaScript 异步流程中透传日志上下文和错误栈，核心是**保持执行链路的上下文可追溯性**，而不是依赖调用栈（异步会中断原生栈）。关键在于手动携带唯一 traceId、显式传递上下文、统一错误捕获与包装。
用 traceId 贯穿整个异步链路
每次发起一个业务操作（如一次 HTTP 请求、一个定时任务、一个用户行为），生成唯一 traceId（例如用 `crypto.randomUUID()` 或短 uuid），并把它作为上下文对象的一部分，随异步调用逐层透传：
- 不要依赖闭包或全局变量存 traceId —— 容易被覆盖或丢失
- 推荐把 traceId 放入函数参数、Promise resolve 值、事件 payload、Axios config headers、Worker.postMessage 数据中
- 示例：调用 API 时，在请求头注入
headers: { 'X-Trace-ID': traceId }；后端也透传，实现前后端串联
封装异步工具函数，自动注入 & 提取上下文
避免每个 await 都手动传 traceId。可封装如 withContext(fn, ctx) 或基于 Promise 的增强版 fetch：
- 自定义
asyncWrap(fn, context)：执行 fn 前将 context 绑定到当前执行流（如通过AsyncLocalStorage） - Node.js 16.8+ 推荐用 AsyncLocalStorage（ALS）—— 它能跨 async/await、setTimeout、Promise.then 自动延续上下文
- 浏览器暂无 ALS 原生支持，可用
cls-hooked（不推荐生产）或更轻量方案：把 context 作为显式参数 + 工具函数自动附加到 console 方法（如log('msg', { traceId })）
错误对象必须重包装，保留原始 stack 和上下文
原生 throw err 或 reject(err) 会丢失 traceId 和父级信息。应统一用自定义错误类包装：
立即学习“Java免费学习笔记（深入）”；
- 创建
BusinessError类，构造时接收原始 error、traceId、额外字段（如 service、step、input） - 把原始 error.stack 保存为
this.causeStack，同时在新 error.stack 中追加 traceId 和简要上下文 - 所有 catch 块里不做
console.error(err)，而是调用reportError(err, { traceId })，统一打日志 + 上报
日志输出格式标准化，强制包含 traceId 和层级标识
每条日志（包括 info、warn、error）都必须带 traceId，并体现异步深度（可选）：
- 格式示例：
[trace:abc123][user:U789][step:login→validate→db] 用户校验失败 - 可在日志库（如 pino、winston）中配置 serializers，自动注入 ALS 中的 traceId
- 避免只在 error 里打 traceId —— info 日志缺失 traceId 就无法关联排查路径
不复杂但容易忽略的是：上下文透传不是“加个参数”就结束，而是一套约定 + 工具 + 规范的组合。从入口（如 Express middleware / React event handler）开始注入 traceId，中间所有异步分支（fetch、setTimeout、Web Worker、IndexedDB）都明确携带，错误处完整包装，日志处统一渲染——整条链才算真正可追踪。
