中国 帮助

多租户下的应用

多租户下最容易搞混的是:哪些东西按租户、哪些东西一个部署里只有一份。 这一页把两者分开列清楚,并说明"别人还在用就不动全局的东西"那道闸。 数据分类的原始口径见 [数据模型](/docs/wujies/5.x/platform/archi

多租户下的应用
封面

> 本文整理自平台文档 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容