async 函数中的 try/catch 并非万能——它仅覆盖你显式 await 的 Promise 拒绝、await 后紧跟的同步错误,以及 thenable 的 then 方法抛出的异常。换句话说,遗漏 await、回调中的异步错误、或者未 await 的 Promise,都不会自动进入 catch 块。理解这些边界,才能在 JavaScript 异常处理时做到心中有数。

async 函数内部的异常处理,仅覆盖 该函数作用域内、且被 await 显式等待的 Promise 拒绝(reject)或同步抛出的错误。它不会自动捕获未 await 的 Promise 错误、纯回调异步操作(如 setTimeout 回调、事件监听器)、或函数外部发生的异常。
哪些错误可以被 try/catch 成功捕获
在 async 函数中,仅当满足以下任一条件时,错误才会进入 catch 块:
- await 紧随的 Promise 被 reject(例如 fetch 请求失败、API 返回 5xx 状态码、手动 throw new Error())
- await 表达式之后、catch 之前出现的同步错误(如 JSON.parse 解析无效字符串、访问 undefined 的属性)
- await 等待一个 thenable 对象,且其 then 方法在执行时抛出异常
无法被自动捕获的错误场景
以下常见情况不会触发 async 函数内的 try/catch 捕获:
- 遗漏 await:直接调用 Promise 但未使用 await,错误会以 rejected Promise 形式返回,但不会中断函数执行,也不会进入 catch
- 未 await 的 Promise 链中的 reject(例如
someApi().catch(handleErr)写在 try 外部) - setTimeout、setInterval 回调函数内部的 throw
- addEventListener 回调中的同步错误
- Promise 构造函数中未被 await 的 reject(例如
new Promise((_, reject) => reject('oops'))但未 await 它)
理解异常传播路径的关键性
async 函数始终返回一个 Promise。如果内部未捕获错误,该 Promise 将变为 rejected 状态。这意味着:
- 调用方可以通过
.catch()或外层 await + try/catch 捕获它 - 如果调用方也未处理,错误最终会上升到全局(可能触发
unhandledrejection事件) - 错误不会凭空消失,但若层层都不处理,就容易导致静默失败
推荐做法:根据需求分层兜底
不要将所有 await 堆在一个大 try 块中。更合理的方式是:
- 对强依赖的串行步骤(例如用户→订单→详情),共用一个 try/catch,体现业务逻辑的耦合性
- 对可独立失败的操作(例如并行加载头像和通知设置),分别 await 并各自使用 .catch() 或 Promise.allSettled()
- 在最外层调用处(例如组件生命周期、事件处理器)添加兜底 try/catch,防止未预期错误导致页面崩溃
- 对特定错误类型(如 401 未授权、网络断连、解析失败)做差异化的处理,而非统一 console.error
