Electron(Node.js)运行时定位第三方未决Promise方法咨询

1. 利用Chromium DevTools的异步调试功能 #

• 打开DevTools设置（齿轮图标），在Experiments里勾选Async stack traces和Promise debugging，重启DevTools后，在Sources面板调试时，pending状态的Promise会保留完整的async调用链，能直接看到触发await的代码行。
• 将第三方库文件加入黑名单：在Sources面板右键第三方库脚本，选择"Blackbox Script"，调试时会跳过第三方代码的细节，但保留调用栈里的关键节点，方便定位到你的代码中调用第三方库的位置。

2. 全局Hook Promise构造函数（不修改第三方代码） #

• 在应用启动、第三方库加载前，重写全局Promise，记录每个Promise的创建栈，并定时检查是否长期pending：

const OriginalPromise = window.Promise;
window.Promise = function(...args) {
  let resolved = false;
  let rejected = false;

  const promise = new OriginalPromise((resolve, reject) => {
    // 包裹resolve/reject，标记状态
    args[0]((val) => {
      resolved = true;
      resolve(val);
    }, (err) => {
      rejected = true;
      reject(err);
    });
  });

  // 记录创建时的调用栈
  promise._creationStack = new Error().stack;

  // 超时检查，自定义阈值（比如10秒）
  setTimeout(() => {
    if (!resolved && !rejected) {
      console.error("发现长期pending的Promise，创建栈：\n", promise._creationStack);
    }
  }, 10000);

  return promise;
};

• 注意：如果第三方库使用了独立封装的Promise实现，可能需要额外Hook对应的构造函数，但大部分库会依赖全局Promise，这个方法能覆盖多数场景。

3. Electron启动时添加调试参数 #

• 启动Electron时带上以下命令行参数：

electron --trace-warnings --async-stack-traces your-app-entry.js

• 这两个参数会强制生成更完整的异步调用栈日志，结合输出的警告信息，能定位到触发未决Promise的await代码位置，对主进程代码的调试效果尤为明显。

4. 通过内存快照分析pending Promise #

• 在DevTools的Memory面板拍摄Heap Snapshot，搜索Promise并筛选出未完成的实例。
• 查看每个pending Promise的Retainers（引用链），能找到它的创建位置以及关联的async函数调用链，从而定位到触发await的代码行。

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