JavaScript async/await中try-catch捕获不到错误的情况

JavaScript 中的 async/await 配合 try-catch 极大地简化了异步代码的错误处理，但在某些特定场景下，错误会“溜走”，导致 catch 块无法捕获。以下是导致这种情况的常见原因及修复步骤。

情况一：try 块内包含未 await 的异步操作

这是最常见的原因。当你调用一个 async 函数或返回 Promise 的函数时，如果没有使用 await 关键字，代码会继续执行而不等待该操作完成。此时，try-catch 块早已执行完毕，后续产生的 Promise 拒绝（Rejection）无法被捕获。

问题复现

运行以下代码：

async function fetchData() {
  throw new Error('请求失败');
}

async function main() {
  try {
    // 错误：没有使用 await
    fetchData(); 
    console.log('代码继续执行...');
  } catch (e) {
    console.log('捕获到错误：', e.message);
  }
}

main();

你会在控制台看到 代码继续执行...，随后出现一个未处理的 Promise 拒绝警告，而不是进入 catch 块。

修复步骤

1. 定位到 try 块中调用的异步函数。
2. 在函数调用前添加 await 关键字。

修复后的代码：

async function main() {
  try {
    // 修复：添加 await
    await fetchData(); 
    console.log('代码继续执行...');
  } catch (e) {
    console.log('捕获到错误：', e.message);
  }
}

情况二：异步回调函数（如 setTimeout）中的错误

try-catch 只能捕获同一个事件循环中、且在 try 作用域内同步执行的代码错误。像 setTimeout、setInterval 或事件监听器这类异步回调，它们的执行主体会被推迟到未来的某个时间点。此时，外层的 try-catch 块已经执行结束并从栈中弹出，回调中的错误无法被外层捕获。

为了更直观地理解执行流程，请看下图：

问题复现

运行以下代码：

async function main() {
  try {
    setTimeout(() => {
      throw new Error('定时器中的错误');
    }, 100);
  } catch (e) {
    console.log('捕获到错误：', e.message);
  }
}

main();

程序会崩溃或抛出未捕获的异常，catch 块中的日志不会出现。

修复步骤

1. 将回调函数本身声明为 async 函数。
2. 在回调函数内部重新使用 try-catch 包裹可能出错的代码。

修复后的代码：

async function main() {
  try {
    setTimeout(async () => {
      // 修复：在回调内部使用 try-catch
      try {
        throw new Error('定时器中的错误');
      } catch (e) {
        console.log('内部捕获：', e.message);
      }
    }, 100);
  } catch (e) {
    console.log('外部捕获：', e.message);
  }
}

情况三：Promise 构造函数中的异步抛错

在 new Promise() 的 executor 函数中，如果错误是同步抛出的（例如 throw new Error()），Promise 会自动将其状态转为 rejected，外层可以通过 catch 捕获。但是，如果在 executor 内部使用了 setTimeout 或其他异步宏任务，并在其中抛出错误，这个错误就无法被 Promise 的 .catch() 或外层的 try-catch 捕获，因为它没有调用 reject() 方法。

问题复现

运行以下代码：

async function main() {
  try {
    await new Promise((resolve, reject) => {
      setTimeout(() => {
        // 这是一个“逃脱”的错误
        throw new Error('Promise 内部的异步错误');
      }, 100);
    });
  } catch (e) {
    console.log('捕获到错误：', e.message);
  }
}

main();

修复步骤

1. 在异步回调中捕获错误。
2. 调用 reject(err) 将错误传递给 Promise 实例，使其可以被 await 捕获。

修复后的代码：

async function main() {
  try {
    await new Promise((resolve, reject) => {
      setTimeout(() => {
        try {
          // 模拟一个错误
          const err = new Error('Promise 内部的异步错误');
          // 修复：调用 reject
          reject(err); 
        } catch (e) {
          reject(e);
        }
      }, 100);
    });
  } catch (e) {
    console.log('捕获到错误：', e.message);
  }
}