动态路由菜单由后端接口返回结构化数据驱动，前端据此生成路由和侧边栏；关键要求是接口数据必须符合vue router v4的routerecordraw标准，含path、name、component（需前端解析为import()表达式）、meta等必需字段，并区分routes（路由注册）与menus（菜单展示），支持嵌套路由children及权限标识，且响应需支持登录态变更后的动态刷新。
动态路由菜单渲染不是靠前端硬编码写死的，而是由后端接口返回结构化菜单数据，前端据此生成路由和侧边栏。关键在于接口返回的数据格式是否符合 vue-router 的 addRoute 或 addRoutes 要求，且字段语义清晰、嵌套合理。
接口必须返回符合 Vue Router v4 的 route record 结构
很多团队自己定义菜单字段（比如叫 menuList、items），但前端 router.addRoute() 只认标准 RouteRecordRaw。如果后端返回字段名不匹配（如用 componentPath 代替 component），或没处理异步组件加载逻辑，就会白屏或报 Invalid route component 错误。
- 必需字段：至少包含
path、name、component、meta（含title、icon等） -
component值不能是字符串路径（如"views/user/index.vue"），而应是动态 import 表达式结果，即() => import("@/views/user/index.vue")—— 这个必须由前端解析，后端只提供相对路径标识符（如"user/index"），再由前端映射为 import 调用 - 嵌套路由需显式带
children数组，且每个子项也满足上述结构；空 children 或null会导致formatRouter递归崩溃
接口要区分「路由」和「菜单」两层数据
一个常见误区是后端把所有导航项都塞进同一数组，导致权限控制失效。比如“系统设置”页面需要访问，但其下的“日志管理”按钮用户无权点击 —— 如果接口不分离路由定义与菜单展示字段，前端就无法做细粒度隐藏。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 推荐返回结构中包含
routes和menus两个顶层字段：前者专注路由注册（含hidden: true的非菜单路由，如 404、重定向），后者专注侧边栏/顶部导航渲染（含visible: false控制显示） -
meta中应明确携带权限标识，例如permissions: ["sys:user:list", "sys:user:edit"]，而不是仅靠role字段做粗粒度判断 - 若使用 gin-vue-admin 类框架，后端接口返回的
menus字段通常已含btns（按钮级权限），但该字段不会自动注入到路由 meta 中，需前端手动合并
接口响应必须兼容登录态变更后的动态刷新
用户切换角色或权限被后台修改后，前端不能只缓存首次请求结果。如果接口没做 ETag 或 Last-Modified 处理，或前端没在 token 刷新后主动重新拉取菜单，就会出现“有权限但点不开”的问题。
- 接口应支持带
Cache-Control: no-cache响应头，避免 CDN 或浏览器强缓存旧菜单 - 前端调用时机很重要：不能在
router.beforeEach里每次跳转都请求，也不能只在登录成功时请求一次；推荐在用户进入首页前（如守卫中检测!store.state.asyncRouters.length）触发，且加防抖 - 错误处理要具体：
401需清空路由并跳登录页；403应保留当前路由但禁用相关菜单项，而非直接报错弹窗
最易被忽略的是 component 字段的运行时解析逻辑 —— 它不依赖接口返回值本身，而依赖前端约定的路径映射规则。一旦后端返回的模块标识符（如 "system/user"）和前端 import() 动态路径（如 @/views/${module}.vue）对不上，整个动态路由链就断了，且错误堆栈极难定位。
