SaaS 多租户
开关 lemon.tenant.enabled(环境变量 LEMON_TENANT_ENABLED,默认 false)。关闭时只有平台租户,行为与单租户系统完全一致;开启后多个卖家共用一套部署,数据按租户隔离。
隔离方式
- 共享数据库、共享表,业务表都有
tenant_id列,唯一约束为「原列 + tenant_id」(编码、单号、店铺 + 平台 SKU 在租户内唯一)。 - MyBatis-Plus 的
TenantLineInnerInterceptor给所有 SQL(包括 mapper XML 中的 JOIN、子查询、UNION)自动追加tenant_id = 当前租户,INSERT 自动填充,业务代码不需要关心租户。 - 平台共享的表(菜单、字典类型、定时任务、租户与套餐、用户角色等关系表)没有
tenant_id,登记在TenantProperties.ignoreTables。 - 当前租户在
framework/tenant/TenantContext:已登录请求按会话设置,@Async线程自动传递,定时任务按租户逐个执行(订单同步、库存回传等都在各自租户中运行),没有租户上下文时访问租户表直接报错。
平台租户、套餐与行业模板
- 平台租户(ID 1,「柠檬科技」)管理租户和套餐;菜单、字典、参数设置、租户、服务监控、缓存监控、定时任务是平台专属功能。
- 租户套餐限定租户可用的菜单;租户管理员的菜单随套餐同步。
SysFeatureCatalog把菜单归为功能模块(基础平台、跨境电商、采购、销售记录、进销存报表、库存、仓储作业、总账、应收应付、资金费用、资产、成本核算、预算分析、智能),模块声明依赖(如跨境电商依赖库存、销售记录和应收应付)。行业模板是模块的组合:跨境电商卖家、国内电商卖家、商贸批发、全部功能。新建租户时选行业即可开通对应功能。
新租户初始化
开通租户时建立根部门、租户管理员(首次登录改密码)、复制平台的内置岗位角色,再由各模块的 TenantInitializer 复制基础数据:
| 初始化器 | 内容 |
|---|---|
FinTenantInitializer | 币种、会计科目、收支类别 |
WmsTenantInitializer | 物料分类、规格属性、价格列 |
SysDictTenantInitializer / SysPrintTenantInitializer | 业务字典(电商站点、运输方式、退货原因、收款平台等)、预置打印格式 |
WfTenantInitializer | 流程模型(未发布的草稿,审批角色换成新租户的角色) |
DevTenantInitializer | 各平台默认佣金费率 |
写新代码时注意
- 新建业务表加
tenant_id BIGINT NOT NULL DEFAULT 1,唯一约束末尾加tenant_id。 - 不要写
INSERT ... SELECT(插件处理不完整),先查询再批量INSERT ... VALUES;不要用TRUNCATE。 - 按编码等租户内唯一的值作缓存 key 时带上租户 ID。
- OAuth 回调等匿名请求没有登录会话,靠签名的 state 携带租户(见 OAuth 授权)。
- 新租户需要的基础数据,在本模块实现
TenantInitializer。