Vue路由守卫配合动态路由的核心是:beforeEach拦截未登录或无路由状态并暂停导航拉取权限,beforeResolve二次校验权限与预加载数据,路由注册后通过router.push重试导航,并借助Pinia持久化实现刷新恢复。

Vue 路由守卫配合动态路由触发加载逻辑,核心在于:在导航确认前完成权限校验、拉取后端路由配置、转换并注册路由,再放行导航。整个过程必须串在守卫生命周期里,不能错序,也不能漏调 next。
在 beforeEach 中拦截未登录/无路由状态
这是第一道闸口,判断是否需要中断导航、跳转登录,或暂挂等待路由加载:
- 若用户未登录(无 token),直接
next('/login') - 若已登录但
router.getRoutes().length === 1(仅剩 login/404 等静态路由),说明动态路由尚未加载,需暂停导航、拉取权限数据 - 此时不要直接
next(),而是用next(false)暂停,并发起异步请求(如getUserInfo或getAsyncRoutes) - 请求成功后,用
filterAsyncRoutes把后端返回的字符串路径(如"dashboard/index")映射为真实组件,再逐条调用router.addRoute()
在 beforeResolve 中做二次校验与预加载
这个守卫在所有异步组件加载完、所有组件内守卫执行后才触发,适合补全关键逻辑:
- 检查当前
to.meta.requiresAuth是否满足角色权限(比如后端返回了user.role,而目标路由要求['admin']) - 对需要预取数据的页面(如订单列表页),在此处调用
fetchOrderList({ page: 1 }),避免进组件后再 loading 闪一下 - 如果校验失败,可安全调用
next('/403')或next(false),不会导致白屏或死锁
确保路由加载完成后重新触发导航
动态路由注册是异步操作,注册完不能直接“刷新页面”,而要让 Vue Router 主动重试当前导航:
立即学习“前端免费学习笔记(深入)”;
- 推荐做法:在
beforeEach中检测到需加载路由时,不调用 next(),而是把to存入临时变量(如pendingRoute),然后发起请求 - 请求成功并完成
addRoute后,手动调用router.push(pendingRoute)—— 这会再次走一遍守卫流程,此时router.hasRoute(to.name)为 true,自然通过 - 避免用
router.replace(to),否则浏览器历史栈会丢失,前进/后退异常
配合 Pinia 持久化与刷新恢复
页面刷新后,动态路由会丢失,必须重建。这和守卫联动的关键点是:
- 在
main.js初始化时,先从 Pinia store 检查是否有缓存的asyncRoutes和userInfo - 若有且 token 有效,直接
addRoute;若无或过期,则在beforeEach中按上述流程拉取 - 把
userInfo和asyncRoutes存入 Pinia 的persist选项,保证刷新不丢权限上下文



















