菜单管理
目录、菜单、按钮三级资源的维护,动态路由的生成规则与菜单缓存清理。
菜单管理维护系统的导航结构与权限标识,功能入口在「系统管理 -> 菜单管理」,后端接口前缀为 /system/menu,对应 MenuController。菜单数据存储在 sys_menu 表,同时承担「路由配置」与「权限资源」两个职责。
菜单类型
菜单类型由 type 字段区分,取值来自 MenuTypeEnum。
| 类型 | 值 | 用途 |
|---|---|---|
| 目录 | 1 | 一级分组,只负责组织与展示,不指向页面 |
| 菜单 | 2 | 具体页面,配置路由地址与组件路径,参与动态路由生成 |
| 按钮 | 3 | 页面内操作点,只配置权限标识,用于按钮级鉴权 |
菜单字段
sys_menu 表的主要字段如下。
| 字段 | 说明 |
|---|---|
title | 标题,同一上级下唯一(uk_title_parent_id 联合唯一索引) |
parent_id | 上级菜单 ID,根节点为 0 |
type | 类型(1:目录;2:菜单;3:按钮) |
path | 路由地址;外链菜单填完整 URL(http/https 开头) |
name | 组件名称,仅随菜单数据下发;前端路由由文件路由按目录生成,不依赖该字段 |
component | 组件路径,对应前端 continew-ui/src/routes/(main)/(app)/ 下的路由目录 |
redirect | 重定向地址 |
icon | 图标 |
is_external | 是否外链 |
is_cache | 是否缓存(登记项,当前前端页签切换没有组件级缓存) |
is_hidden | 是否隐藏,隐藏后不出现在侧边栏,但路由仍可访问 |
permission | 权限标识,如 system:user:create |
sort | 排序,默认 999 |
status | 状态(1:启用;2:禁用) |
路由地址与组件路径的填写规则
MenuController.preHandle 在新增、修改时统一修正参数。
- 勾选「是否外链」时,
path必须以http://或https://开头,否则报「路由地址格式不正确」; - 非外链时,
path不允许是完整 URL,保存时自动补前导/;name与component自动去除前导/。
前端登录后调用 /auth/user/route 拉取当前用户可见的菜单树,页面由 TanStack 文件路由承接:在 continew-ui/src/routes/(main)/(app)/ 下按菜单路径建目录并写一个 route.tsx,即生成对应路由。菜单里没有的路径由访问守卫(src/lib/route-access.ts)重定向到无权限页;菜单里有入口而页面文件还没建时,占位页会提示预期的文件路径。component 填相对路径(不带前导 /、不带扩展名),例如 system/user/index。目录约定与守卫细节见路由与页签。
权限标识与按钮鉴权
按钮类型(type = 3)的 permission 字段是后端接口鉴权的依据。CRUD 类接口由 BaseController.preHandle 按「模块:资源:动作」自动生成权限码,例如 POST /system/user 要求 system:user:create。前端按钮经 usePermission 的 hasPermission 做条件渲染裁剪,无权限时不渲染,用法见权限控制。
新增业务模块时,在菜单管理中录入目录、页面与按钮菜单(按钮的 permission 填权限标识)后即可挂到角色上。按钮权限标识建议与后端权限码保持一致,避免前后端两张皮。
清除缓存
角色-菜单关联结果缓存在 Redis(键前缀见 CacheConstants.ROLE_MENU_KEY_PREFIX)。菜单或角色调整未即时生效时,可点击「清除缓存」(DELETE /system/menu/cache,权限码 system:menu:clearCache)按前缀批量删除缓存键,下次请求重新加载。
相关源码
- MenuController(/system/menu 接口与参数修正)
- MenuTypeEnum(菜单类型枚举)
- MenuServiceImpl(菜单树与路由构建)
- 前端页面 continew-ui/src/routes/(main)/(app)/system/menu