核心是“先保底、再补权”:启动时仅注册/login、/404等静态公共路由;登录后异步获取菜单数据,转换为合法RouteRecordRaw格式并用router.addRoute动态注入,同时存入localStorage,配合全局守卫实现刷新恢复、越权拦截与登出清理。

核心是“先保底、再补权”:启动时只注册登录页、404等无需权限的路由;用户登录后,拉取后端返回的菜单数据,转换为合法路由配置,用 router.addRoute() 动态注入,并配合全局守卫处理刷新、越权和登出清理。
1. 静态路由打底,确保基础可访问
项目初始化时,不加载任何需权限的页面。只在 router/index.ts 中硬编码公共路由:
-
/login:登录页,meta.hidden = true,不显示在菜单中 -
/404或/not-found:兜底页面 -
/重定向到/dashboard(该 dashboard 组件本身也属于静态路由,仅作占位)
这些路由使用动态导入,如 () => import('@/views/login/index.vue'),保证按需加载且与用户状态解耦。
2. 登录后拉取并转换菜单为合法路由
后端通常返回扁平或树形结构的菜单数据,例如:
前端必须完成三件事才能被 router.addRoute() 正确识别:
- 把
component: "user/List"转为异步组件:() => import('@/views/user/List.vue') - 确保
path是完整路径(避免嵌套时重复拼接),name全局唯一 - 补全
meta字段,如icon、roles、hidden,用于后续菜单渲染和守卫判断
3. 动态注入 + 守卫兜底,防白屏、防越权
调用 router.addRoute(route) 后,新路由立即生效,但需注意:
- 若用户刚跳转到
/user这类尚未注入的路径,需在守卫中手动next({ path: to.path })触发重匹配 - 全局前置守卫中判断:
!router.hasRoute(to.name) && 已登录→ 先拉菜单、注入路由、再放行 - 刷新页面会丢失动态路由,需将转换后的菜单存入
localStorage;守卫检测到无路由但有 token,就先读缓存、注入、再放行
4. 登出时彻底清理,避免权限残留
用户退出必须清除所有动态痕迹:
- 遍历之前注入的路由
name,逐个调用router.removeRoute(name) - 清空
localStorage中缓存的菜单数据 - 重置 Pinia store 中的
menuList和相关状态
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










