PostgreSQL / 系统课时
用复合外键阻断跨租户引用
用复合外键阻断跨租户引用
RLS 能阻止用户直接读取其他租户的数据,但父子表只用单列外键时,仍可能把本租户记录指向另一个租户的对象。本课用包含 tenant_id 的复合外键,把“引用必须留在同一租户”变成数据库不可绕过的完整性约束。
学习目标
- 识别单列外键在共享表中的跨租户引用风险
- 用
(tenant_id, parent_id)复合外键约束父子关系 - 验证合法同租户引用成功、跨租户引用得到
23503
单列外键为什么不够
假设 projects 和 project_members 都是共享表。若成员表只有 project_id REFERENCES projects(project_id),数据库只检查项目 ID 是否存在,不知道成员记录里的 tenant_id 应该与父项目属于同一个租户。
正确模型让父表提供 (tenant_id, project_id) 候选键,并让子表同时携带这两列作为外键。数据库匹配的是一对值,而不是只匹配项目 ID。

建立父子两侧的复合键
下面的完整实验先插入两个不同租户的项目,再插入一条合法成员关系,随后故意尝试跨租户引用。异常被 PL/pgSQL 捕获,所以脚本可以继续查询最终数据。
BEGIN;
CREATE TEMP TABLE lesson_projects (
tenant_id bigint NOT NULL,
project_id bigint NOT NULL,
name text NOT NULL,
PRIMARY KEY (tenant_id, project_id)
);
CREATE TEMP TABLE lesson_project_members (
tenant_id bigint NOT NULL,
member_id bigint NOT NULL,
project_id bigint NOT NULL,
PRIMARY KEY (tenant_id, member_id),
CONSTRAINT fk_project_same_tenant
FOREIGN KEY (tenant_id, project_id)
REFERENCES lesson_projects (tenant_id, project_id)
);
INSERT INTO lesson_projects (tenant_id, project_id, name)
VALUES
(101, 7, 'Alpha'),
(202, 9, 'Beta');
INSERT INTO lesson_project_members (tenant_id, member_id, project_id)
VALUES (101, 1001, 7);
DO $$
BEGIN
INSERT INTO lesson_project_members (tenant_id, member_id, project_id)
VALUES (101, 1002, 9);
EXCEPTION
WHEN foreign_key_violation THEN
RAISE NOTICE 'cross-tenant reference blocked, SQLSTATE=%', SQLSTATE;
END
$$;
SELECT tenant_id, member_id, project_id
FROM lesson_project_members
ORDER BY tenant_id, member_id;
ROLLBACK;预期结果中,通知文本证明跨租户写入触发外键违规,最终查询只保留合法成员关系。不同客户端可能对事务状态行采用不同格式。
NOTICE: cross-tenant reference blocked, SQLSTATE=23503
tenant_id | member_id | project_id
-----------+-----------+------------
101 | 1001 | 7
(1 row)失败的记录写着 tenant_id=101, project_id=9,而父表中的项目 9 只存在于租户 202。由于父表没有 (101, 9) 这一对键,复合外键直接拒绝它。
设计时同时检查三处边界
父表必须对外键引用列提供主键或唯一约束,所以 (tenant_id, project_id) 不能只是“查询时习惯一起写”,而应是正式候选键。子表也必须把 tenant_id 设为 NOT NULL;否则允许空租户值会让普通外键的 NULL 语义绕过匹配检查。
当关系链更长,例如订单指向项目、项目成员指向项目、任务再指向项目时,每一条需要租户隔离的引用都应重复这个模式。数据库约束负责结构完整性,RLS policy 再负责限制当前会话能操作哪些租户行,两层职责不同且应同时存在。
如果父对象本来就是全局共享资源,例如所有租户共同引用同一张国家代码表,就不应强行加入租户复合外键。是否包含 tenant_id 取决于关系本身是否要求“父子必须同租户”,而不是表是否恰好部署在同一个数据库中。