如何定位Node.js中因Promise永不resolve导致卡住的await位置

• 超时包装法：最容易落地的方案，给所有外部来源的Promise套一层超时封装，超时后主动抛出带位置标识的错误，调用栈会直接指向卡住的await行。代码示例：

// 通用超时包装函数
function withTimeout(promise, timeoutMs = 5000, hint = '') {
  return Promise.race([
    promise,
    new Promise((_, reject) => {
      setTimeout(() => {
        reject(new Error(`Promise timed out after ${timeoutMs}ms, 位置标识: ${hint}`))
      }, timeoutMs)
    })
  ])
}

// 业务调用时添加位置标识即可，超时会直接抛错带出完整调用栈
await withTimeout(getBadPromise(), 3000, '第1次调用getBadPromise')
await withTimeout(getBadPromise(), 3000, '第2次调用getBadPromise')
await withTimeout(getBadPromise(), 3000, '第3次调用getBadPromise')
// 后续调用以此类推

• 内置调试器定位：无需修改业务代码，启动Node进程时添加--inspect参数，打开Chrome浏览器输入chrome://inspect找到对应Node进程进入调试面板，程序卡住后手动点击暂停执行按钮，查看左侧调用栈即可直接定位到当前处于等待状态的await语句位置。
• async_hooks追踪法：利用Node.js内置的async_hooks模块捕获所有Promise的初始化调用栈，定时扫描pending状态超过阈值的Promise，直接打印对应的初始化调用栈，无需修改业务代码就能全局监控卡住的Promise。简单实现示例：

const async_hooks = require('async_hooks');
const pendingPromises = new Map();

const hook = async_hooks.createHook({
  init(id, type) {
    if (type === 'PROMISE') {
      pendingPromises.set(id, {
        stack: new Error().stack,
        createTime: Date.now()
      });
    }
  },
  resolve(id) {
    pendingPromises.delete(id);
  }
});
hook.enable();

// 定时检查超过3秒未完成的Promise
setInterval(() => {
  const now = Date.now();
  for (const [, info] of pendingPromises.entries()) {
    if (now - info.createTime > 3000) {
      console.log('检测到卡住的Promise，调用栈如下：\n', info.stack);
    }
  }
}, 1000);

• 活跃资源检查法：线上紧急排查时可直接调用process._getActiveHandles()和process._getActiveRequests()获取当前Node进程中所有活跃的异步资源，结合业务上下文即可快速对应到卡住的异步任务位置。

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