> 本文整理自平台文档 docs/wujies/1.x/advanced/menu-ownership.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-71cffd49caaf-cover.svg)
这一页解决什么问题:应用声明的菜单落进 sys_menu 之后就是普通行 —— 「系统管理 → 菜单管理」里谁都能改 path / component / perms,也能直接删掉。 本页讲清三件都能自己核对的事:
1. 平台怎么认出一行菜单属于哪个应用(四张表反查,不需要给 sys_menu 加列); 2. 哪些操作会被拒(只有三类操作,其中两类被拒,其余一律放行); 3. 为什么归属必须连后代一起算(按钮那层不在映射表里)。
菜单清单本身怎么写不在这里,见 [菜单与权限](/docs/wujies/1.x/plugin-dev/advanced/menus) 与 [应用清单 app.json](/docs/wujies/1.x/plugin-dev/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/update/app_market.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 / deleteMenuById | ObjectProvider<MenuOwnershipProvider> 注入,缺席即"没有受保护菜单" |
| 标注 | GET /app/console/owned-menus(权限 system:menu:list)+ 宿主前端 plus-ui/src/views/system/menu/index.vue | 菜单列表里打应用名标签、禁用删除按钮与路由字段 |
要动框架的实体 / VO / Mapper XML / 菜单管理页面(sys_menu 是平台表), 而且会和 app_version_menu 形成两份真相;更关键的是归属本质是「版本 → 菜单」 而不是「菜单 → 应用」:同一应用的不同版本可以有不同菜单树。 三点代价的完整推导见 [数据库表](/docs/wujies/1.x/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/1.x/reference/config))。
所以实际效果是: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)建索引,
回归测试:`wujies-platform/wujies-modules/wu
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-71cffd49caaf-guide.svg)


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