架构与系统设计 / 系统课时

平台数据与租户数据

平台数据与租户数据

多租户系统最容易出错的地方,不是有没有 tenant_id,而是没有先定义数据归谁、谁能读、谁能改。本课建立四类数据边界,并用表结构与查询约束把平台数据、公共配置、租户私有数据和可共享数据真正区分开。

学习目标

  • 能按所有权、可见范围和维护主体划分四类数据
  • 能为不同数据类型选择是否携带 tenant_id
  • 能通过唯一索引与查询条件阻止跨租户读写

先按三个问题判断数据归属

设计一张表前,先回答三个问题:数据由谁创建和维护,哪些租户可以读取,修改后影响单个租户还是整个平台。只看“是否公共”不够,因为公共可读的数据也可能只能由平台维护。

平台与租户数据分层图

四类数据可按下表落地:

数据类型 典型内容 维护主体 tenant_id 设计
平台级字典 国家、币种、行业分类 平台 通常不需要
公共配置 默认参数、平台公告、基础模板 平台 通常不需要,可增加版本与启停状态
租户私有数据 订单、客户、员工、租户自定义配置 当前租户 必须存在且不可为空
可共享数据 模板市场、跨租户协作对象 创建方与平台规则共同决定 需要所有者字段和可见范围字段

四类数据的表结构差异

平台数据的关键是“全局唯一”和“统一维护”,租户私有数据的关键是“租户内唯一”。例如订单号只需在同一租户内唯一时,唯一索引必须包含 tenant_id,否则不同租户使用相同业务编号会发生冲突。

下面的 MySQL 8.0 示例创建四类最小表,并演示租户内唯一约束:

sql
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;

预期输出:

text
tenant_id  merchant_order_no  amount_cent
1001       ORDER-001          9900
1002       ORDER-001          19900

两个租户可以使用相同的业务订单号,因为唯一性范围被限定在租户内部。若唯一索引只有 merchant_order_no,第二条数据会错误地被判定为重复。

查询时必须显式携带租户条件

私有表有 tenant_id 还不够,所有查询、更新和删除都必须带当前租户条件。应用层应从可信身份上下文取得租户编号,而不是直接相信请求参数中的 tenant_id。

安全查询应同时限定主键和租户:

sql
SELECT id, merchant_order_no, amount_cent
FROM tenant_order
WHERE id = 1
  AND tenant_id = 1001;

预期输出:

text
id  merchant_order_no  amount_cent
1   ORDER-001          9900

更新和删除也应使用同样的组合条件。仅按主键操作虽然可能命中唯一记录,但会绕过租户边界,形成越权入口。

可共享数据不能等同于无租户数据

共享数据仍然有所有者,只是读取范围扩大。最小模型通常包含 owner_tenant_id、visibility 和资源状态;更复杂的定向共享还需要独立授权表,记录被授权租户、权限和有效期。

读取共享模板时,应满足“自己拥有”或“公开可见”:

sql
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,由所有权和可见范围决定,不由表名决定
  • 租户私有数据必须在字段、索引和查询条件三个层面同时隔离
  • 可共享数据仍需保留所有者与授权规则,不能退化为无归属的公共数据

下一课预告

下一课将把这些数据边界应用到存量系统,演示如何为单租户表补充租户归属,并通过灰度步骤完成安全迁移。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

平台数据与租户数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通