在异步开发场景下，许多开发者遇到过这样的困惑：明明在 async 函数外层包裹了 try-catch，内部的 setTimeout 回调抛出错误时却无法捕获，导致程序中断或报错信息缺失。这并非 try-catch 失效，而是 JavaScript 事件循环机制导致的执行上下文隔离。

核心原理：事件循环与调用栈

JavaScript 是单线程事件驱动模型。当代码执行到 setTimeout 时，浏览器或 Node.js 运行时会将回调函数注册到宏任务队列，然后立即继续执行后续代码。当 try 块执行完毕时，调用栈已经清空，此时 setTimeout 回调才在未来的某个时间点入栈执行。由于执行上下文已经切换，外层 try-catch 无法感知新栈帧中抛出的异常。

简单来说，try-catch 只能保护“当前正在执行”的代码段。一旦代码进入异步队列（如 setTimeout、setInterval、DOM 事件回调），它就脱离了原始 try 块的保护范围。

代码修正方案

不要直接在 setTimeout 里 throw，而是让定时器返回一个状态可控的 Promise。以下是错误写法与修正对比：

// ❌ 错误写法：try-catch 无法捕获
async function run() {
  try {
    setTimeout(() => {
      throw new Error('定时任务失败'); // 此处错误会逃逸
    }, 1000);
  } catch (e) {
    console.log('捕获不到', e);
  }
}

// ✅ 正确写法：包装为 Promise
function waitAndFail(delay) {
  return new Promise((resolve, reject) => {
    setTimeout(() => {
      reject(new Error('定时任务失败')); // 通过 reject 传递错误
    }, delay);
  });
}

async function run() {
  try {
    await waitAndFail(1000); // await 等待 Promise 状态
  } catch (e) {
    console.log('成功捕获', e.message);
  }
}

环境差异化处理

除了代码层面的修正，针对不同运行环境，还需要配置全局错误监听作为兜底策略。请注意区分浏览器与 Node.js 环境的 API 差异。

浏览器环境

在浏览器中，可以使用 window.onerror 或 window.onunhandledrejection 监听未被捕获的错误：

window.onerror = function(message, source, lineno, colno, error) {
  console.error('全局错误捕获:', message);
  return true; // 阻止默认错误处理
};

window.onunhandledrejection = function(event) {
  console.error('未处理的 Promise 拒绝:', event.reason);
};

Node.js 环境

在 Node.js 环境中不存在 window 对象，需使用 process 对象监听全局异常，否则会导致进程退出：

process.on('uncaughtException', (err) => {
  console.error('未捕获的异常:', err);
  // 建议记录日志后优雅退出，避免状态不一致
  process.exit(1);
});

process.on('unhandledRejection', (reason, promise) => {
  console.error('未处理的 Promise 拒绝:', reason);
});

验证与调试

1. 观察控制台：运行修正后的代码，确认控制台没有红色的 Uncaught Error 报错，且 catch 块内的 console.log 正常输出。

2. 打断点调试：在 catch 块内设置断点，确认程序执行流确实进入了异常处理分支，而不是直接中断。

3. 检查全局监听：如果保留了全局监听，确认在修复后该全局监听不再被触发，说明错误已被局部妥善处理。

常见工程坑点

1. 忘记 return Promise：包装函数如果忘记 return 新的 Promise，外层 await 得到的将是 undefined，无法捕获内部错误。

2. 混用回调与 Promise：在同一个函数中混合使用 callback 风格和 Promise 风格，容易导致错误状态传递不一致。

3. 忽略未捕获的 Promise：即使使用了 Promise，如果忘记加 .catch() 或 await 外层没有 try-catch，仍会触发 unhandledrejection 事件。

4. 环境 API 误用：切勿在 Node.js 代码中直接使用 window.onerror，反之亦然，需根据运行环境判断全局对象。