Vue 3 中 Promise 拒绝需显式处理：推荐链末单点 .catch() 或 setup 中 await+try/catch；Promise.all 等需针对性兜底；全局 unhandledrejection 可监听遗漏错误。
在 Vue 3 中，Promise 链里的拒绝状态（rejected）不会自动被 Vue 的错误边界或 errorCaptured 钩子捕获，必须显式处理。优雅的关键不是到处写 .catch()，而是分层拦截、集中响应、不破坏业务逻辑流。
用单点 .catch() 捕获整条链的错误
Promise 链具备错误冒泡特性：只要链中任意环节 reject，且后续没有 .catch()，错误就会一直传到末尾。因此，在链的最末端加一个 .catch() 就能兜住所有中间环节的异常。
- 推荐写法：
apiCall().then(handleSuccess).catch(handleError) - 避免写法：
apiCall().then(...).then(...).catch(...)中间漏掉某一层的异常可能被吞掉 - 注意：如果某层
.then()内部手动 throw 或返回被 reject 的 Promise，也会触发后续.catch()
在 setup() 中结合 await + try/catch 更直观
Composition API 下，async/await 是 Promise 链的语法糖，语义更清晰，错误处理也更符合直觉。
Vue Composition Analyzer
下载
分析 Vue 3 Composition API 使用情况——审计响应式模式、可组合函数设计、ref 与 reactive 的选择、计算属性、watcher 使用及组件……
- 直接用
try { const res = await api.post(...) } catch (err) { ... } - 错误对象包含完整堆栈和响应信息（如 axios 的
err.response?.data） - 适合表单提交、页面初始化等有明确“成功/失败”分支的场景
对 Promise.all / Promise.any 做针对性兜底
这些组合方法的错误行为特殊，不能靠通用 .catch() 一揽子解决：
立即学习“前端免费学习笔记（深入）”；
-
Promise.all([...])：任一 Promise reject → 整体 reject，返回第一个失败原因；需.catch()显式接住 -
Promise.allSettled([...])：永远 resolve，每个结果带status: 'fulfilled' | 'rejected'，适合需要汇总全部结果的场景 -
Promise.any([...])：全 reject 才 reject，错误类型是AggregateError，需检查err.errors数组
全局未捕获 Promise 拒绝的兜底监听
即使业务层写了 .catch()，仍可能遗漏某些异步分支（比如定时器里发起的请求、第三方 SDK 触发的 Promise）。此时可注册全局监听：
- 在
main.js或入口处添加：window.addEventListener('unhandledrejection', e => { handleError(e.reason) }) - 配合 Sentry 或自建日志上报，记录未预期的拒绝原因
- 注意：该监听仅适用于真正“未被捕获”的 reject，不能替代业务层的主动错误处理
