动态路由需在Action中请求菜单接口并转换为RouteRecordRaw[],经校验后通过addRoute挂载到指定layout的children下,刷新时通过路由守卫检查Pinia缓存并补全。

在 Action 中发起路由数据请求并解析
登录成功后,调用 Action 获取后端返回的菜单/路由配置(通常是 JSON 格式),并做基础校验与结构转换。例如过滤无效项、补全 component 路径、处理嵌套 children 等。
- 接口应封装在 src/api/menu.ts 等独立模块,Action 内只负责 await 调用
- 返回数据建议统一为 RouteRecordRaw[] 或可直接映射的扁平数组
- 常见转换逻辑(如 path→component 动态导入)放在工具函数中,比如 mapMenusToRoutes()
通过 router.addRoute 或 addRoutes 批量注册
Action 获取并转换好路由列表后,调用 vue-router 的 addRoute(单条)或遍历调用(多条),推荐挂载到已有 layout 路由的 children 下,避免污染根级路由表。
- 确保目标父路由已声明 children: [] 且有 name(如 'dashboard'),否则 addRoute('dashboard', route) 会失败
- 若需完整替换动态部分,可用 router.getRoutes().filter(...) 配合 router.removeRoute() 清理旧路由
- 注册完成后,建议触发 router.isReady() 确保路由系统同步更新,再执行跳转
配合状态管理控制加载与错误反馈
在 Action 内维护 loading、error、menuList 等响应式字段,让 UI 可感知路由加载过程。组件中可据此展示骨架屏、错误提示或禁用导航。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 开始请求时设 this.loading = true,finally 中设为 false
- 错误时赋值 this.error = '菜单加载失败,请重试',不抛出异常也可在组件中监听
- 成功后保存 this.menuList = parsedRoutes,便于后续权限判断或菜单渲染
处理刷新后路由丢失问题
页面刷新会导致动态添加的路由消失,需在应用启动阶段(如 router.beforeEach)检查 Pinia 中是否已有 menuList,没有则触发 Action 补全。
- 可在 pinia store 的 onMounted 或路由守卫中判断 !store.menuList.length && store.token
- 首次进入时自动拉取,避免白屏;已有缓存(如 localStorage 存过路由)可快速恢复
- 注意:router.addRoute 不会持久化,每次刷新都需重新注册,这是预期行为










