async/await错误堆栈需主动增强上下文才能追溯调用链：通过注入traceid、扩展error.stack、启用chrome/node.js异步堆栈补全、监听unhandledrejection事件、结合asynclocalstorage绑定执行上下文，将割裂的异步片段串联为可读因果链。
async/await 的错误堆栈本身不天然包含完整调用链，关键在于让 Error 对象携带可追溯的上下文信息——不是靠堆栈“自动变长”，而是通过主动增强错误对象、启用运行时追踪能力、结合结构化日志，把割裂的异步片段串成一条因果线。
让 Error 自带路径标识
默认抛出的 Error 只记录抛出点，不体现 await 链上游。可在关键入口处手动注入 trace 信息：
- 创建错误时附加业务上下文：
throw new Error(`[API: getUser] ${err.message}`) - 用
Error.captureStackTrace（Node.js）或扩展error.stack字符串，在抛出处拼接当前函数名、参数简写、时间戳 - 避免只写
throw err——这会丢失原始堆栈；应throw Object.assign(new Error(), err, { traceId: currentTraceId })
启用浏览器/Node.js 原生异步堆栈补全
现代运行时已支持跨 await 的堆栈回溯，但需确认开启：
- Chrome 120+：DevTools → Settings → 勾选 “Enable JavaScript stack trace on async tasks”（新版默认开）
- Node.js：启动时加
--trace-warnings或设置环境变量NODE_OPTIONS=--trace-warnings - 验证方式：在疑似出错行加
console.trace()，若输出中出现at async fetchData (api.js:15:2)而非模糊的promiseReactionJob，说明生效
捕获未处理拒绝并补全堆栈
很多 async 错误根本没走到顶层 try/catch，必须监听全局未捕获事件：
- 浏览器：
window.addEventListener('unhandledrejection', e => { console.error('Uncaught:', e.reason, e.promise); }) - Node.js：
process.on('unhandledRejection', (reason, promise) => { console.error('Unhandled:', reason); }) - 注意：不要只打印
reason，要显式输出reason.stack——它可能比事件对象里的更完整
用 AsyncLocalStorage 注入执行上下文
当错误发生在深层回调（如定时器、事件监听器），单靠堆栈无法定位源头操作，需绑定请求级上下文：
- Node.js 16.14+：创建
const asyncStore = new AsyncLocalStorage()，在入口（如 HTTP 中间件）asyncStore.run({ traceId: uuid(), op: 'login' }, ...) - 任意后续异步回调中：
const ctx = asyncStore.getStore()，出错时一并打日志：console.error(`[${ctx?.op}][${ctx?.traceId}]`, error) - 浏览器端可用 polyfill 或轻量库（如
cls-hooked）实现类似能力
