> 本文整理自平台文档 docs/wujies/5.x/platform/app-market/tenants.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-ae712cbe52fd-cover.svg)
多租户下最容易搞混的是:哪些东西按租户、哪些东西一个部署里只有一份。 这一页把两者分开列清楚,并说明"别人还在用就不动全局的东西"那道闸。
数据分类的原始口径见 [数据模型](/docs/wujies/5.x/platform/architecture/data-model) 与 [应用生命周期](/docs/wujies/5.x/platform/app-market/lifecycle)。
三类数据,租户归属各不相同
| 类别 | 表 | 租户归属 |
|---|---|---|
| 目录 | app_info、app_version、app_category、app_plan、app_version_menu | 平台级,不按租户隔离(这几张表本来就在租户排除清单里,都没有 tenant_id) |
| 安装实例 | app_install、app_install_task | 每个部署各一份,带 tenant_id → 按租户安装 |
| 迁移记录 | app_schema_history | 每个部署各一份,去重判据不带租户(表结构在所有租户间共享) |
应用按租户安装与授权
只是各有一份安装记录。
- 装一个应用只影响本租户:
app_install多一条记录、本租户的角色多一批菜单授权。 - 别的租户要用,得自己装一次(或者由平台方按套餐开通)。工作台「三方应用」那组的副标题
- 目录里同一个应用只有一个条目 —— 租户 A 和租户 B 装的是同一个
app_info/app_version,
菜单行不分租户,分的是"可见性"与"授权"
sys_menu 里的菜单行是全局行:清单 upsert 出来的就是那一棵,所有租户共用。 按租户区分的是另外两样:
| 分租户的东西 | 存在哪 | 怎么起作用 |
|---|---|---|
| 授权 | sys_role_menu | 挂在本租户的角色上。装的时候只授一个角色,其余手工加,见 [装完以后:菜单与权限](/docs/wujies/5.x/platform/app-market/menus) |
| 可见性 | 菜单过滤器的隐藏清单,按租户缓存在 AppMenuCache | 本租户停用或卸载过的应用,它的菜单不再出现在该租户的菜单树里 |
所以同一行菜单行,在 A 租户的菜单树里出现、在 B 租户里不出现,是正常现象,不是数据错乱。
一个部署内全局共享的东西
下面这些不按租户分,一个部署里只有一份:
| 全局的东西 | 位置 |
|---|---|
| 菜单行(含按钮等后代) | sys_menu |
| 应用自己的业务表 | 数据库里那张表本身(租户隔离落在业务表的 tenant_id 与框架的租户插件上,不是"每租户一套表") |
| 迁移执行记录 | app_schema_history |
| 本机产物 | 后端 jar(插件落位目录)、前端产物目录、active-plugins.txt |
| 应用自带的字典与站点配置 | 字典表与参数表里以应用编码为前缀的那些行 |
| 跑着的插件后端 | 宿主进程里的插件运行时(每个应用一份子上下文 + 类加载器) |
那道闸:别人还在用就不动全局的东西
「彻底删除」时,如果还有别的租户装着同一个应用,就会跳过所有全局清理 —— 菜单 / 数据表 / 迁移记录 / 本机产物 / 字典与站点配置一律不删,只在任务日志里逐条说清 "检测到还有 N 个租户装着该应用:菜单与数据表是全局共享的,已跳过删除"。
判据是 app_install 里状态非 uninstalled 的其它记录 —— 会排除自己那条 (此时自己这条的状态还没改成 uninstalled,不排除的话判据永远成立、功能直接失效)。
这么做是因为反过来等于替别的租户做了一个不可恢复的决定。
第二道闸是平台表前缀保护:只删迁移脚本里声明过的表,表名命中 sys_ / app_ / gen_ / flow_ / act_ / qrtz_ / snailjob_ / undo_log 前缀时一律跳过并告警, 防止一个写错的脚本把平台表带下水。
app_install.status 是按租户的,但跑着的插件后端在进程里只有一份。 停用与卸载的实现都是 unload(关掉那个应用的子 Spring 上下文与类加载器、注销它的接口), 源码里没有像彻底删除那样的"还有别的租户在用吗"判断。
所以租户 A 停用(或卸载)一个应用之后,仍在启用它的租户 B 会看到菜单还在、但接口已经摘掉 —— 此时服务端给的是「已启用但产物未加载」这类可区分的提示,而不是一句"请求地址不存在"。
这一条是读源码得出的(停用 / 卸载都调插件的 unload,而共享闸只存在于彻底删除的清理路径里), 没有实机验证过。多租户共用一套插件后端时,建议先在自己环境上验一遍再依赖它。
如果你的部署是多租户共用,而你想让某个租户看不到这个应用,停用其实不是一个纯本租户操作。 稳妥的做法是走授权:不给该租户的角色分配那棵菜单。
租户排除清单:哪些表要亲手挡掉框架的租户条件
application.yml 里 tenant.excludes 那串表名不是随手列的白名单。MyBatis Plus 的多租户插件会往没被排除的表的 SQL 里拼 tenant_id,所以判错的代价是一段直接报错的 SQL,或者一行被写成别人的租户。清单里目前有四类,各自的判据不同。
第一类,压根没有 tenant_id 列的表:app_info / app_version / app_category 这些目录表,app_route_index、app_version_route,以及 app_license。
插件 jar 只有一份、路由清单是目录侧数据、授权买的是「这一套部署」而不是「这一个租户」,三种说法指向同一个事实:这些行不该按租户切。漏进清单的后果很具体,多租户插件会拼出一个不存在的列:
Unknown column 'tenant_id' in 'where clause'
app_route_index 那条尤其难查:写失败只打一行 WARN,表现是「墓碑表永远是空的」,读侧看着像正常空表。代码侧(如 AppLicenseService、路由清单读写处)另外套了一层 TenantHelper.ignore 做第二道保险,但那道保险不能代替清单,它只覆盖代码里显式包住的调用。
第二类,有 tenant_id 列但归属边界不是租户的表:app_license_order、app_license_activation、app_redeem_code 三张许可证台账表。
判据不是「有没有那一列」,而是「这行归谁」。许可证属于 sys_user 这个账号:
- 运营在平台租户(
000000)的台账里给客户账号签发,行的归属人在自己的租户里。自动拼上tenant_id后,客户查自己买的东西永远返回空行,这是功能不成立,不是少几行; - 兑换码由运营在一个租户下批量生成、客户在另一个租户下兑换。
code = ? AND status = 'unused'那句 CAS 被拼上租户条件后永远匹配不到行,兑换必然失败; - 插入侧更糟:不排除时插件按当前会话给
INSERT补tenant_id,「运营替客户签的那一行」被打上运营的租户,这一列从那一刻起没有一致含义。
所以这三张表的 tenant_id 由代码显式赋值,含义固定为「归属账号所在租户」,只用于对账与统计;权限边界由显式的 user_id 谓词承担(AppLicenseLedgerService 里那个私有方法,客户侧所有端点共用,先按 orderId 取行再断言 owner)。
代价要讲清楚:进了这份清单就没有框架层兜底。新加一个端点漏写 user_id 谓词,等于跨账号读取别人的许可证、凭证与备注。加表时顺手加进清单可以,必须同时补谓词。
「这张表的行,归属于租户,还是归属于账号 / 部署 / 全局?」
答「租户」就别加;答不上来,先去看那张表的写入路径是谁触发的。第一类和第二类的排除理由完全不同,把第二类的写法抄给第一类,会漏掉那个 user_id 谓词。
表结构与逐条迁移理由见 script/sql/app_market_schema.sql 第 14–17 节。
相关阅读
- [安装、升级、卸载与启停](/docs/wujies/5.x/platform/app-market/install) —— 两种卸载模式的操作与差别
- [装完以后:菜单与权限](/docs/wujies/5.x/platform/app-market/menus) —— 授权按租户落到角色上
- [数据模型](/docs/wujies/5.x/platform/architecture/data-model) —— 三类数据与全部表的字段
- [应用目录](/docs/wujies/5.x/platform/app-market/catalog) —— 目录为什么在一个部署内全局共享
界面截图
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-ae712cbe52fd-guide.svg)


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