await 不捕获微任务中抛出的错误,仅响应所等待 promise 的终态;微任务内 throw 会生成新 rejected promise,需显式用 .catch() 或 try/catch 拦截,否则触发 unhandledrejection。

因为 await 本身不“捕获”错误,它只是等待 Promise 的终态;而微任务内部(比如 Promise.resolve().then(() => { throw new Error() }))抛出的错误,如果没有被 Promise 链上的 .catch() 或外层 try/catch 捕获,就会变成未处理的拒绝(unhandledrejection,控制台报红),但 await 并不会自动为它兜底。
await 只响应 Promise 的 reject,不监听微任务执行上下文
await p 等价于 return p.then(v => v, e => { throw e }) —— 它只关心 p 这个 Promise 实例最终是 fulfilled 还是 rejected。如果错误发生在 p resolve 后的微任务中(例如 p.then(() => { throw ... })),那这个新错误属于**另一个新 Promise**,和原 p 无关,await 对它完全无感知。
举个典型例子:
-
async function fn() { await Promise.resolve(); throw new Error('这里会被 catch'); }→await后的同步 throw,能被外层 try/catch 捕获 -
async function fn() { await Promise.resolve().then(() => { throw new Error('这里不会被 await 捕获') }); }→ 错误发生在新的微任务中,await已结束,该 Promise 被 reject,但没被处理 → 触发unhandledrejection
微任务错误必须由其所属 Promise 链负责捕获
每一个 Promise 链(包括 .then、.catch、await)都只对自身链路上的 rejection 负责。微任务里的 throw 会自动被包装成一个 rejected Promise,但它需要显式用 .catch() 或包裹它的 try/catch 来拦截。
正确写法示例:
- 用
await+try/catch:try { await Promise.resolve().then(() => { throw 'oops' }); } catch(e) { console.log(e); } - 用
.catch()终止链路:await Promise.resolve().then(() => { throw 'oops' }).catch(e => e) - 避免在
.then中裸 throw,改用Promise.reject()显式传递,语义更清晰
常见陷阱:误以为 await 能“兜住所有异步错误”
开发者常混淆两个概念:
- await 某个 Promise:只管那个 Promise 的状态
-
await 后面跟着的表达式里再产生新 Promise:比如
await fetch(...).then(...),这时.then返回的新 Promise 的错误,仍需单独处理
例如:await fetch(url).then(res => res.json()) —— 如果 res.json() 抛错(如非法 JSON),这个错误属于 .then 返回的 Promise,不是 fetch() 本身,所以必须确保整个链有 catch 或外层 try/catch。
补充:全局兜底不能替代主动捕获
虽然可以监听 window.addEventListener('unhandledrejection', ...) 做日志或降级,但它只是补救措施,无法阻止错误发生,也不能恢复执行流。生产环境必须在业务逻辑层面明确每个可能出错的 Promise 是否已被处理。











