异步组件加载失败的全局兜底需路由层、组件层、框架层协同：路由配置中用catch包裹import()返回轻量兜底组件；router.onerror统一捕获未处理异常并跳转错误页；suspense或defineasynccomponent配置error fallback提供ui反馈；构建与服务端确保chunk路径一致、404 fallback及灰度降级。
异步组件加载失败时，全局化兜底不是靠单一机制，而是由路由层、组件层、框架层三者协同完成。核心目标是：不让用户看到白屏或卡在 loading，不中断导航流程，同时保留可追踪、可降级、可提示的能力。
路由配置中提前捕获并降级
这是第一道防线，必须在定义路由时就处理 import() 的拒绝态，不能等到导航守卫里再干预。
- 用 catch() 包裹动态导入，返回一个轻量兜底组件（如 ErrorFallback.vue）
- 避免在 beforeEach 中尝试拦截——此时 import 还没执行，守卫无法感知 Promise 状态
- 示例（Vue Router 4）：
{
path: '/admin',
component: () => import('./views/Admin.vue')
.catch(() => import('./components/ErrorFallback.vue'))
}
]
router.onError 统一响应未被捕获的加载异常
当某个异步组件没在路由里加 catch，或者错误发生在更底层（如 chunk 加载失败），router.onError 就是最后的兜底入口。
iSlide PPT
下载
一款AI演示文稿工具，主要用于DeepSeek AI加持，输入主题生成专业PPT，支持Word/PDF等45种文档导入，职场汇报、教学提案轻松搞定，适合需要提升相关任务效率的用户。
- 必须在 createRouter() 之后、app.use(router) 之前 注册
- 检查 error.message 是否含 "500"、"Failed to fetch"、"Loading chunk" 等特征关键词
- 可跳转至统一错误页，并携带 query 参数标识错误类型，便于埋点和排查
用 Suspense 或 defineAsyncComponent 配置 error fallback
仅靠路由兜底还不够，用户需要明确的 UI 反馈。Suspense 是 Vue 原生支持异步状态切换的容器，defineAsyncComponent 则提供更细粒度控制。
- Suspense：自动识别 pending / resolved / rejected 状态，需确保异步工厂函数最终 reject（如超时或 404），否则不会触发 #fallback 插槽
- defineAsyncComponent：支持直接传入 error 选项，指定错误时渲染的组件；还可配 delay、timeout 控制展示时机
- 二者都应配合骨架屏、重试按钮等设计，提升可操作性
服务端与构建层协同增强健壮性
前端兜底只是体验优化，真正减少失败，得从源头入手。
- 构建工具（Vite/Webpack）确保 chunk 输出路径与部署路径一致，避免 404
- Nginx 或 CDN 层对 /js/*.js 请求配置 fallback，比如 404 时返回一个最小兜底 HTML
- 服务端接口可增加灰度开关，对特定用户/环境直接返回预编译的降级组件
- 前端上报错误时带上模块路径、网络状态、UA，方便快速定位是普遍问题还是局部故障
