异步流中传递业务上下文日志的关键是让上下文自动随执行路径流动，Node.js 16+ 推荐使用 AsyncLocalStorage 实现请求级上下文绑定与自动延续，需注意第三方异步操作导致的上下文丢失并手动恢复，错误对象应结构化携带上下文以实现日志与监控双向关联。
在异步流中传递业务上下文日志，关键不是“把日志塞进去”，而是让上下文信息能自动跟随异步执行路径流动，确保每个错误、每条日志都自带 requestID、用户ID、操作类型等关键字段。
用 AsyncLocalStorage 绑定请求级上下文
Node.js 16+ 原生支持 AsyncLocalStorage，它是目前最稳定、性能友好、无需侵入业务代码的方案。它像一个“异步作用域内的全局变量”，在一次请求生命周期内自动延续上下文，不依赖手动透传。
- 初始化一个实例：const als = new AsyncLocalStorage();
- 在入口（如 Express 中间件）调用 als.run({ traceId, userId, path }) 包裹后续逻辑
- 任意深度的异步函数里，直接 als.getStore() 就能拿到完整上下文对象
- 日志工具（如 pino、winston）可统一读取该上下文，自动注入到每条日志中
避免手动透传，但需补全关键边界
AsyncLocalStorage 在大多数场景下自动生效，但在以下情况可能丢失上下文：
- 第三方库内部使用了 setTimeout / setImmediate / nextTick 且未做上下文继承
- 显式创建新 Promise 并在 executor 中启动异步操作（如 new Promise(resolve => setTimeout(...))）
- 事件监听器（如 EventEmitter.on）或某些底层回调
此时可在关键跳转点手动“恢复”上下文，例如：
立即学习“Java免费学习笔记（深入）”；
const ctx = als.getStore();<br>setTimeout(() => {<br> als.run(ctx, () => doSomething());<br>});
错误对象携带上下文，而非仅打日志
光有带上下文的日志还不够——当错误被抛出或上报时，它本身应结构化包含上下文。推荐做法：
- 自定义错误类（如 BusinessError），构造时接收 context 并挂载为 .context 属性
- 在 catch 块中，用当前 als.getStore() 补充错误：throw new BusinessError('DB timeout', { context: als.getStore() })
- 监控系统（如 Sentry）可配置提取 .context 字段，实现错误与链路日志双向关联
前端可类比使用 Zone.js 或 React Context + ErrorBoundary
浏览器环境无 AsyncLocalStorage，但可通过：
- Zone.js（Angular 默认集成）：拦截异步任务，提供类似上下文隔离能力
- React Context + useReducer：在请求发起时存入 context，配合自定义 Hook（如 useApi）自动注入和捕获
- 手动包装 fetch / axios：添加 traceId header，并在响应拦截器中将上下文附加到 error 对象
