中国 帮助

菜单归属与保护

这一页解决什么问题:应用声明的菜单落进 sys_menu 之后就是普通行 —— 「系统管理 → 菜单管理」里谁都能改 path / component / perms,也能直接删掉。 本页讲清三件都能自己核对的事: 1. 平台怎么认出一行

菜单归属与保护
封面

> 本文整理自平台文档 docs/wujies/5.x/platform/app-market/menu-ownership.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-822822c337f6-cover.svg)

这一页解决什么问题:应用声明的菜单落进 sys_menu 之后就是普通行 —— 「系统管理 → 菜单管理」里谁都能改 path / component / perms,也能直接删掉。 本页讲清三件都能自己核对的事:

1. 平台怎么认出一行菜单属于哪个应用(四张表反查,不需要给 sys_menu 加列); 2. 哪些操作会被拒(只有三类操作,其中两类被拒,其余一律放行); 3. 为什么归属必须连后代一起算(按钮那层不在映射表里)。

菜单清单本身怎么写不在这里,见 [菜单与权限](/docs/wujies/5.x/platform/plugin/advanced/menus) 与 [应用清单 app.json](/docs/wujies/5.x/platform/plugin/basics/manifest)。

归属从哪来:app_version_menu 的四表反查

菜单同步时已经把 (version_id, menu_id, menu_key) 写进了 app_version_menu, 它就是权威记录。反查链是四跳:

app_install(本租户装了哪些应用,这张表带 tenant_id)
  → app_info(app_code / app_name)
  → app_version(这些应用的**所有**版本)
  → app_version_menu(version_id → menu_id)

app_version_menu 的列与约束(DDL 在 wujies-platform/script/sql/app_market_schema.sql):

列含义
id主键(雪花,MyBatis-Plus ASSIGN_ID)
version_id指向 app_version.version_id
menu_id指向 sys_menu.menu_id
menu_key清单里 menus[].key 的落库名(幂等 upsert 的依据)

唯一键 uk_version_menu (version_id, menu_id)、uk_version_menu_key (version_id, menu_key), 另有 idx_version_menu_menu (menu_id) —— 归属反查走的就是这条索引。

接线一共四处:

角色位置说明
契约wujies-platform/wujies-common/wujies-common-core/src/main/java/cn/wujies/common/core/menu/MenuOwnershipProvider.java宿主通用模块不能反向依赖 app-market;MenuOwner(appCode, appName)
实现wujies-platform/wujies-modules/wujies-app-market/src/main/java/cn/wujies/appmarket/service/AppMenuOwnershipProvider.java四表反查 + 后代展开,只排除 del_flag='1' 的记录
拦截wujies-platform/wujies-modules/wujies-system/src/main/java/cn/wujies/system/service/impl/SysMenuServiceImpl.java 的 updateMenu / deleteMenuByIdObjectProvider<MenuOwnershipProvider> 注入,缺席即"没有受保护菜单"
标注GET /app/install/owned-menus(权限 system:menu:list)+ 宿主前端 wujies-admin/src/views/system/menu/index.vue菜单列表里打应用名标签、禁用删除按钮与路由字段

要动框架的实体 / VO / Mapper XML / 菜单管理页面(sys_menu 是平台表), 而且会和 app_version_menu 形成两份真相;更关键的是归属本质是「版本 → 菜单」 而不是「菜单 → 应用」:同一应用的不同版本可以有不同菜单树。 三点代价的完整推导见 [数据库表](/docs/wujies/5.x/platform/reference/database) 第 12 节。

### 租户边界:带 tenant_id 的只有第一跳

AppMenuOwnershipProvider 的类注释写「租户过滤交给 MyBatis-Plus 插件(不 ignore)」—— 这句话是对的,但看代码时要接着看清一件事:四张表里只有 app_install 带 tenant_id, app_info / app_version / app_version_menu 都在 tenant.excludes 里(平台级全局表, 见 wujies-platform/wujies-admin/src/main/resources/application.yml 与 [配置项](/docs/wujies/5.x/deploy/configuration))。

所以实际效果是:A 租户装的应用,不会让 B 租户的同名菜单被保护, 差别只产生在 app_install 那一跳;目录与映射本身是全部署共用一份的。

另一个容易误判的点:归属查询只排除 del_flag='1',不按安装状态过滤。 所以停用(disabled)的应用,它的菜单仍受保护 —— 它随时可能被重新启用; 「卸载(保留数据)」同理,安装记录还在,菜单行也还在,归属自然还在。

保护策略:只有三类操作

操作允许?理由
改 path / component / perms / menuType / parentId❌ 拒绝与插件代码、前端路由、权限标识绑死,改一个字段页面就打不开或权限失效
改菜单名 / 图标 / 排序 / 显隐(menuName / icon / orderNum / visible / status)✅ 放行管理员按自己的习惯调,没有风险
删除❌ 拒绝删了只能靠重装 / 升级该应用恢复;想隐藏请改成「停用」

判据在 SysMenuServiceImpl.assertAppMenuEditable:它逐字段比对「库里的当前行」与「本次提交的 BO」, 只有真的变了才计入。BO 里传 null 表示"本次不修改该字段"(与 MyBatis-Plus updateById 忽略 null 一致),不会被当成"要改成 null"—— 否则只改菜单名的请求也会被误拦。

被拒时抛的是 ServiceException,原文如下(可直接拿来对日志):

菜单「<菜单名>」由应用「<应用名>」安装,不能修改<路由地址、组件路径、权限标识、菜单类型、上级菜单里变了的那些>。
这些字段与插件代码和前端路由绑定,改了会导致页面打不开或权限失效。
如需调整,请修改该应用的 app.json 后重新打包升级;只改名称、图标、排序、显隐是可以的。

菜单 <menuId>(<应用名>) 由应用安装,不能在菜单管理里删除 ——
删掉之后只能靠重装或升级该应用恢复。如果只是想让它不显示,请改为「停用」或停用该应用。

归属要连后代一起算(AppMenuTreeExpander)

映射表里只有清单声明过的菜单,而 sys_menu 里还有一层: 按钮(menu_type='F',例如 gallery:image:query)—— 它们历史上来自平台初始化 SQL, 从来不在映射表里。只看映射表会同时坏两件事,而且都是静默的:

场景只看映射表的后果
菜单保护按钮不受保护,管理员能随手删掉应用按钮,恢复只能靠重装
彻底删除应用按钮成孤儿(父菜单没了、自己还挂在 parent_id 上),菜单管理页里一堆没有父级的按钮

所以归属计算的第 5 步是下钻:AppMenuOwnershipProvider.ownedMenus() 调 AppMenuTreeExpander(同一个类也被 AppPurgeService 用来决定"该删哪些菜单行", 避免两边各写一份然后分叉)。

并在 TenantHelper.ignore(...) 里跑,避免调用方上下文(定时任务等)干扰。

  • withDescendants(roots):返回「roots 自己 + 全部层级后代」;
  • descendantsOf(roots):只要后代;
  • 下钻是广度优先 + LinkedHashSet 去重,数据被手工改坏成环(A 的父是 B、B 的父是 A)
  • loadChildrenByParent() 一次读全表 sys_menu(只取 menu_id / parent_id)建索引,

回归测试:`wujie

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-822822c337f6-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容