Promise需手动注入上下文以支持分布式链路追踪，核心是创建或链式调用时捕获并透传traceId；可选手动透传、Async Hooks（Node.js v14+）、封装工厂函数或浏览器适配方案。
在分布式链路追踪中，Promise 本身不自动携带上下文（如 traceId、spanId），需要手动将追踪上下文注入 Promise 的执行链中。核心思路是：**在 Promise 创建或链式调用时，显式捕获当前上下文，并在后续 then/catch 中恢复使用**。这通常结合异步上下文传播机制（如 Async Hooks 或 Zone.js）或手动透传实现。
手动透传上下文 ID（最轻量、兼容性最好）
适用于无运行时上下文支持的环境（如 Node.js 早于 v14 或浏览器）。关键是在每个 Promise 链节点上把上下文作为参数传递或闭包捕获：
- 创建 Promise 时，将当前 traceId 封装进 resolve/reject 的值中，或通过闭包持有
- 在 then 和 catch 回调中，优先从入参或闭包读取 traceId，再用于日志、HTTP Header 注入或上报
- 避免依赖 this 或全局变量，防止多请求间上下文污染
示例：
const traceId = 'abc123'; // 来自上游请求头或生成Promise.resolve({ data: 'req', traceId })
.then(({ data, traceId }) => {
console.log(`[trace:${traceId}] fetching...`);
return fetch('/api', { headers: { 'X-Trace-ID': traceId } });
})
.then(res => res.json())
.then(data => ({ data, traceId })) // 继续透传
.catch(err => console.error(`[trace:${traceId}] error`, err));
利用 Async Hooks（Node.js 环境推荐）
Node.js v14+ 提供 async_hooks API，可自动追踪异步资源生命周期，实现真正的“隐式”上下文绑定：
立即学习“Java免费学习笔记（深入）”；
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 在 Promise 构造、then 注册、微任务执行等关键点，用 executionAsyncId() 关联上下文存储
- 借助 Map 缓存每个 asyncId 对应的 traceId，在 Promise 回调中自动取出
- 主流 APM 工具（如 OpenTelemetry Node SDK）已内置此机制，只需启用并配置 Propagator
注意：Async Hooks 有轻微性能开销，生产环境建议开启采样；且仅限 Node.js，不适用于浏览器。
封装 Promise 工厂函数统一注入
为降低业务代码侵入性，可封装一个带上下文感知的 Promise 构造器：
- 定义 contextPromise(fn, context)，内部自动将 context 绑定到 fn 执行环境
- 重写 then/catch 方法，在回调执行前激活上下文（例如设置临时 globalThis._currentTrace）
- 配合拦截 fetch、setTimeout 等原生异步方法，自动注入 X-Trace-ID
这种方式平衡了透明性与可控性，适合中大型项目渐进接入。
浏览器环境注意事项
浏览器没有 Async Hooks，但可通过以下方式近似实现：
- 利用 Promise.then 的 microtask 特性，在链首保存上下文，链中通过闭包或 WeakMap 关联 task 与 traceId
- 使用 TaskContext 库或基于 Zone.js（Angular 使用）做异步调度劫持
- 对 fetch/XHR 封装，确保每次请求 header 携带 traceId；前端埋点日志强制打标 traceId
跨 iframe 或 Web Worker 需额外序列化/反序列化上下文，不能依赖内存共享。
