关键是要绕过异步加载,用 mock 替换动态 import 为同步组件实例:通过 jest.mock() 或 vi.mock() 拦截 import('./xxx.vue') 并返回已编译组件,确保 mount 前生效且路径一致;若测路由跳转,则配合 router.push 与 nextTick,但懒加载本身不参与断言。

在单元测试中挂载 Vue 路由懒加载组件,关键不是“等它加载完”,而是**绕过异步加载过程,直接使用同步组件实例**。因为测试环境不模拟真实网络或 chunk 加载,`import('./xxx.vue')` 返回的 Promise 在 Jest 或 Vitest 中默认不会自动 resolve,会导致组件渲染为空、报错或超时。
替换异步组件为同步组件
最稳妥的做法是在测试时用 `jest.mock()` 或 `vi.mock()` 拦截动态 import,强制返回已编译的组件模块:
- 在测试文件顶部 mock 对应路径的异步导入:
Vue 2 / Vue 3(非 defineAsyncComponent)jest.mock('@/views/Home.vue', () => ({ default: { template: '<div>Home Mock</div>' } })) - 若使用 `defineAsyncComponent`(Vue 3),mock 整个函数调用:
jest.mock('vue', () => ({<br> ...jest.requireActual('vue'),<br> defineAsyncComponent: jest.fn(() => ({ template: '<div>Async Mock</div>' }))<br>})) - 确保 mock 在 `mount` 或 `shallowMount` 之前生效,且路径与路由配置中完全一致(包括别名如 `@/`)
使用 router.push + await nextTick(仅限集成测试)
如果测试目标是验证整个路由跳转流程(例如测试守卫逻辑或页面响应),可配合真实 router 实例:
- 创建带真实 history 的 router(如 `createWebHistory()`),但需避免实际加载——仍需提前 mock 组件
- 调用
await router.push('/home'),再加await nextTick()确保 Vue 更新队列清空 - 检查是否渲染了预期内容,而不是等待 Promise;懒加载本身不参与测试断言,只作为配置存在
避免常见错误
以下做法容易失败,不推荐:
立即学习“前端免费学习笔记(深入)”;
- 不 mock 直接 mount 含 `() => import(...)` 的路由组件 → 渲染出 `` 或报错 “Cannot find module”
- 试图用
await waitFor(() => expect(...).toBeVisible())等待懒加载完成 → Webpack chunk 机制在测试中不触发 - 在测试中手动 resolve 动态 import 返回的 Promise → 违反模块隔离,不可靠且难维护
本质上,单元测试关注的是组件行为和逻辑,不是构建产物的加载时机。把懒加载当成“配置项”,测试时用同步替代,既快又稳定。



















