Node.JS async函数中如何保留完整stack trace

• V8引擎生成错误堆栈的核心规则：Error对象的堆栈信息，是在实例化Error的瞬间抓取当前同步执行上下文的调用栈生成的。你当前在Promise链的.catch()回调中执行throw new Error(...)，这个回调属于Promise调度的微任务，被引擎从微任务队列取出执行时，当前同步调用栈的起点是Promise内部的微任务入口，外层makeHttpRequest的调用方、路由处理函数、Express框架层的栈帧都不在当前同步栈中，自然不会被记录到错误堆栈里。
• 额外代码问题：路由处理函数myHandler未声明为async，内部直接使用await会触发语法错误；同时非async函数内的异步异常无法被Express正确捕获传递给错误处理中间件，会进一步加剧栈信息丢失、错误无法被日志中间件采集的问题。

1. 修正路由处理函数声明，添加async关键字，保证Express可以正确捕获async函数抛出的异常，传递给后置的错误处理中间件：

const myHandler = async (req, res) => {
  // 业务逻辑
  await makeHttpRequest(/* 调用参数 */)
}

2. 改写makeHttpRequest实现，放弃在Promise链式.catch()微任务回调中包装错误的写法，改用async/await + try/catch结构做错误包装，让Error实例化的上下文和async调用链路连通，V8的异步栈追踪机制就可以顺着await链路抓取到完整的跨异步任务调用栈：

export const makeHttpRequest = async (...) => {
  try {
    return await externalLib(...)
  } catch (err) {
    // Error在async函数上下文内实例化，可关联到完整调用链
    throw new Error(JSON.stringify(err))
  }
}

3. 运行环境兼容：Node.js 12及以上版本默认开启异步栈追踪特性，无需额外配置；如果使用Node.js 12以下的旧版本，启动服务时需要添加--async-stack-traces参数开启该特性。

可选方案：如果必须保留Promise链式写法，可以在捕获错误后手动将外层调用栈信息拼接到新生成Error的stack属性上，但该方案维护成本较高，非特殊场景不推荐使用。

内容的提问来源于stack exchange，提问作者itaied