测试路由守卫的核心是精准控制输入条件并验证其决策行为,如未登录跳转/login、权限不足中断导航;需用createMemoryHistory创建可控路由实例,await router.isReady()后调用router.push触发守卫,mock异步请求,通过spy next或监听afterEach断言重定向路径,确保每个分支都正确调用next。

测试路由守卫逻辑,关键不是“让它真实跳转”,而是**精准控制守卫的输入条件,并验证它是否按预期调用 next、重定向或中断导航**。守卫本身不渲染页面,所以测试重点是它的决策行为——比如:用户未登录时,是否跳转到 /login;权限不足时,是否被拦在门外。
准备可控制的路由实例
避免依赖浏览器环境或真实 history,用内存历史(createMemoryHistory)创建 router 实例,确保测试完全可控:
- Vue 3 + Vue Router 4:在测试文件中调用
createRouter({ history: createMemoryHistory(), routes }) - 挂载组件时通过
router选项传入该实例,而非使用全局 router - 若测试涉及状态(如登录态),提前在 store 或 localStorage 中设置好对应值(例如
localStorage.setItem('token', 'abc'))
模拟守卫触发场景
守卫不会自动运行,需主动触发一次导航才能进入守卫流程:
- 调用
router.push('/protected')模拟用户访问受保护路由 - 必须
await router.isReady()确保路由系统初始化完成,否则push可能静默失败 - 对异步守卫(如检查 API 返回权限),需 mock 相关请求(如用
jest.mock或vi.mock拦截fetch)并返回预设响应
断言守卫的实际行为
不验证页面内容,而验证守卫的“动作输出”:
立即学习“前端免费学习笔记(深入)”;
- 检查是否发生重定向:监听
router.afterEach钩子,断言to.path是否为/login - 验证
next调用方式:若守卫内调用了next('/login'),可通过 spy 包裹next函数(如const next = vi.fn()),再传入守卫执行函数中进行校验 - 对于全局
beforeEach,可在测试 setup 阶段直接调用守卫函数,传入 mock 的to、from和next,然后检查next的调用参数
处理守卫拦截导致的报错
测试中出现 Navigation cancelled 多因守卫未调用 next,或调用时机不对:
- 确保每个分支都调用了
next(包括if/else、try/catch内部) - 异步守卫中,不能在
setTimeout或未 await 的 Promise 后才调用next,否则导航已超时取消 - 测试被拦截的导航时,不要期待目标组件渲染成功,而应捕获
router.onError或检查router.currentRoute.value是否仍为原路径



















