架构与系统设计 / 系统课时
平台数据与租户数据
平台数据与租户数据
多租户系统最容易出错的地方,不是有没有 tenant_id,而是没有先定义数据归谁、谁能读、谁能改。本课建立四类数据边界,并用表结构与查询约束把平台数据、公共配置、租户私有数据和可共享数据真正区分开。
学习目标
- 能按所有权、可见范围和维护主体划分四类数据
- 能为不同数据类型选择是否携带
tenant_id - 能通过唯一索引与查询条件阻止跨租户读写
先按三个问题判断数据归属
设计一张表前,先回答三个问题:数据由谁创建和维护,哪些租户可以读取,修改后影响单个租户还是整个平台。只看“是否公共”不够,因为公共可读的数据也可能只能由平台维护。

四类数据可按下表落地:
| 数据类型 | 典型内容 | 维护主体 | tenant_id 设计 |
|---|---|---|---|
| 平台级字典 | 国家、币种、行业分类 | 平台 | 通常不需要 |
| 公共配置 | 默认参数、平台公告、基础模板 | 平台 | 通常不需要,可增加版本与启停状态 |
| 租户私有数据 | 订单、客户、员工、租户自定义配置 | 当前租户 | 必须存在且不可为空 |
| 可共享数据 | 模板市场、跨租户协作对象 | 创建方与平台规则共同决定 | 需要所有者字段和可见范围字段 |
四类数据的表结构差异
平台数据的关键是“全局唯一”和“统一维护”,租户私有数据的关键是“租户内唯一”。例如订单号只需在同一租户内唯一时,唯一索引必须包含 tenant_id,否则不同租户使用相同业务编号会发生冲突。
下面的 MySQL 8.0 示例创建四类最小表,并演示租户内唯一约束:
DROP TABLE IF EXISTS tenant_order;
DROP TABLE IF EXISTS shared_template;
DROP TABLE IF EXISTS platform_setting;
DROP TABLE IF EXISTS platform_currency;
CREATE TABLE platform_currency (
currency_code CHAR(3) PRIMARY KEY,
currency_name VARCHAR(64) NOT NULL,
enabled TINYINT NOT NULL DEFAULT 1
);
CREATE TABLE platform_setting (
setting_key VARCHAR(64) PRIMARY KEY,
setting_value VARCHAR(255) NOT NULL,
enabled TINYINT NOT NULL DEFAULT 1
);
CREATE TABLE shared_template (
id BIGINT PRIMARY KEY,
owner_tenant_id BIGINT NOT NULL,
template_name VARCHAR(128) NOT NULL,
visibility ENUM('PRIVATE', 'PUBLIC') NOT NULL,
UNIQUE KEY uk_owner_name (owner_tenant_id, template_name)
);
CREATE TABLE tenant_order (
id BIGINT PRIMARY KEY,
tenant_id BIGINT NOT NULL,
merchant_order_no VARCHAR(64) NOT NULL,
amount_cent BIGINT NOT NULL,
UNIQUE KEY uk_tenant_order_no (tenant_id, merchant_order_no),
KEY idx_tenant_created (tenant_id, id)
);
INSERT INTO platform_currency VALUES ('CNY', '人民币', 1);
INSERT INTO tenant_order VALUES
(1, 1001, 'ORDER-001', 9900),
(2, 1002, 'ORDER-001', 19900);
SELECT tenant_id, merchant_order_no, amount_cent
FROM tenant_order
ORDER BY tenant_id;预期输出:
tenant_id merchant_order_no amount_cent
1001 ORDER-001 9900
1002 ORDER-001 19900两个租户可以使用相同的业务订单号,因为唯一性范围被限定在租户内部。若唯一索引只有 merchant_order_no,第二条数据会错误地被判定为重复。
查询时必须显式携带租户条件
私有表有 tenant_id 还不够,所有查询、更新和删除都必须带当前租户条件。应用层应从可信身份上下文取得租户编号,而不是直接相信请求参数中的 tenant_id。
安全查询应同时限定主键和租户:
SELECT id, merchant_order_no, amount_cent
FROM tenant_order
WHERE id = 1
AND tenant_id = 1001;预期输出:
id merchant_order_no amount_cent
1 ORDER-001 9900更新和删除也应使用同样的组合条件。仅按主键操作虽然可能命中唯一记录,但会绕过租户边界,形成越权入口。
可共享数据不能等同于无租户数据
共享数据仍然有所有者,只是读取范围扩大。最小模型通常包含 owner_tenant_id、visibility 和资源状态;更复杂的定向共享还需要独立授权表,记录被授权租户、权限和有效期。
读取共享模板时,应满足“自己拥有”或“公开可见”:
SELECT id, owner_tenant_id, template_name, visibility
FROM shared_template
WHERE owner_tenant_id = 1001
OR visibility = 'PUBLIC';预期结果取决于当前表内数据;验证时应确认私有模板只对所有者可见,公开模板才可被其他租户读取。不要通过把 owner_tenant_id 设为空来表达共享,否则会丢失审计和撤销依据。
边界与常见错误
平台默认配置与租户覆盖配置可以分表保存,也可以使用“平台默认值加租户覆盖表”的模式。读取时先查租户覆盖,未命中再回退平台默认值,避免复制大量相同配置。
常见错误包括:所有表机械添加 tenant_id、平台字典被租户修改、唯一索引遗漏租户维度、共享资源没有所有者、后台任务查询私有表时未绑定租户上下文。任何一种都可能造成数据污染或跨租户泄露。
本课总结
- 数据是否携带
tenant_id,由所有权和可见范围决定,不由表名决定 - 租户私有数据必须在字段、索引和查询条件三个层面同时隔离
- 可共享数据仍需保留所有者与授权规则,不能退化为无归属的公共数据
下一课预告
下一课将把这些数据边界应用到存量系统,演示如何为单租户表补充租户归属,并通过灰度步骤完成安全迁移。