ES6模块中process.on('uncaughtException')异常处理失效问题咨询

这个问题我之前也踩过坑，其实是ES模块和CommonJS在错误处理机制上的设计差异导致的，我来给你拆解清楚～

这确实是Node.js在两种模块系统上的设计差异，核心原因在于加载与执行机制的不同：

• CommonJS模块是同步加载+同步执行的，模块代码中抛出的异常会直接冒泡到全局上下文，因此uncaughtException事件能够顺利捕获这些异常。
• ES模块的加载和顶层代码执行是基于Promise链的：Node.js会把ES模块的加载过程包装成Promise，哪怕是顶层的同步异常，也会被自动转为Promise的拒绝（reject），这些异常不会触发uncaughtException，而是会触发unhandledRejection事件。

举个直观的例子，假设你的module.mjs里直接抛出异常：

// module.mjs
throw new Error('模块加载异常');

当你运行node --experimental-modules index.mjs时，这个异常会被模块加载的Promise捕获，成为未处理的Promise拒绝，只会触发unhandledRejection，而不是uncaughtException。

根据不同的场景，有几种实用的解决方案：

1. 同时监听unhandledRejection事件 #

对于模块加载阶段的异常、顶层同步代码的异常，你需要补充监听unhandledRejection事件来覆盖：

// index.mjs
// 处理CommonJS风格的同步未捕获异常
process.on('uncaughtException', (err) => {
  console.error('捕获到uncaughtException:', err.message);
  process.exit(1);
});

// 处理ES模块中Promise链的未捕获拒绝
process.on('unhandledRejection', (reason) => {
  console.error('捕获到unhandledRejection:', reason.message);
  process.exit(1);
});

// 加载模块（顶层import）
import './module.mjs';

2. 动态加载模块时主动捕获异常 #

如果使用import()动态加载模块，可以直接用try/catch主动捕获加载/执行异常，不需要依赖全局事件，更符合模块化的错误处理思路：

// index.mjs
async function loadModule() {
  try {
    await import('./module.mjs');
  } catch (err) {
    console.error('主动捕获模块异常:', err.message);
    // 这里可以做自定义处理，比如退出进程或执行降级逻辑
  }
}

loadModule();

3. 区分异常场景 #

需要注意：uncaughtException在ES模块中并非完全失效——在非Promise链的同步代码中抛出的未捕获异常（比如定时器回调、事件监听回调里的异常），依然会触发uncaughtException：

// index.mjs
process.on('uncaughtException', (err) => {
  console.error('捕获到uncaughtException:', err.message);
});

// 定时器回调中的异常会触发uncaughtException
setTimeout(() => {
  throw new Error('定时器里的异常');
}, 1000);

• ES模块的加载和顶层执行基于Promise，因此相关异常会触发unhandledRejection而非uncaughtException，这是设计上的差异，并非Bug。
• 建议在ES模块项目中同时监听uncaughtException和unhandledRejection，覆盖所有未处理异常场景；动态加载模块时优先用try/catch主动捕获，代码会更健壮可控。

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