关键在于让“租户归属”成为每个数据操作不可绕过的默认条件,需严格完成识别(子域名/可信请求头)、过滤(全局作用域+RLS兜底)、传递(异步/缓存/日志全链路绑定)和兜底(原生SQL专项加固)四环,缺一即留暗门。

防止跨租户数据泄露,关键不是堆砌技术点,而是让“租户归属”成为每个数据操作不可绕过的默认条件。漏掉识别、过滤、传递、兜底中任一环,就等于在隔离墙上留了暗门。
租户识别必须在请求最前端完成
不能依赖 session、URL 参数或 cookie——这些在定时任务、队列、CLI 命令里根本不存在,也容易被伪造。推荐用子域名(tenant1.example.com)或请求头 X-Tenant-ID 作为唯一可信来源。
- 在中间件中优先读取
$_SERVER['HTTP_X_FORWARDED_HOST'](反向代理场景),再 fallback 到$_SERVER['HTTP_HOST'] - 用正则白名单提取子域名,拒绝下划线、大写字母、非法字符,例如:
/^([a-z0-9\-]+)\.example\.com$/ - 解析出的租户 ID(如
tenant1)必须绑定到请求实例(如$request->tenantId = $tenantId),且该中间件要排在所有其他中间件之前
数据库操作必须强制租户过滤
连对库 ≠ 数据安全。即使用了独立数据库,若模型未声明连接或误用 Db::table(),仍可能串查;若用共享库,没加 tenant_id 条件,就是裸奔。
- 所有模型统一继承基类,基类
boot()中注册全局作用域(如 ThinkPHP 的TenantScope或 Laravel 的 EloquentGlobal Scope) - 过滤条件必须从可信上下文取值(如
app('request')->tenantId),绝不能取自用户输入(URL、表单、JWT payload 未经校验部分) - 写入时自动填充
tenant_id字段,避免手动遗漏;软删除需与租户条件正确组合,防止逻辑失效
绕过 ORM 的路径必须专项加固
原生 SQL、@Query(native = true)、Db::execute()、视图、存储过程、迁移脚本——这些统统跳过全局过滤器,是高频越权入口。
- 禁止字符串拼接 SQL:
"SELECT * FROM orders WHERE id = " . $id→ 永远不用 - 所有原生查询必须显式带
WHERE tenant_id = ?,且参数由中间件注入,不可由前端传入 - PostgreSQL 可启用 RLS 行级安全策略兜底:
CREATE POLICY tenant_isolation ON orders USING (tenant_id = current_setting('app.current_tenant_id')::UUID),但前提是应用层已执行SET LOCAL app.current_tenant_id = 'xxx'
异步与边缘环节必须同步租户上下文
定时任务、队列消费、批量导入、日志记录、缓存键生成——这些地方最容易丢失租户信息,导致数据写错库、缓存污染、审计失联。
- 异步任务(如
@Async、CompletableFuture、ThinkPHP 的queue:work)必须显式传入tenant_id,不能依赖 ThreadLocal(PHP 无原生支持)或全局变量 - Redis 缓存键必须带租户前缀:
tenant:abc:order:1024,不能只用order:1024 - 日志框架(如 Logback MDC 或 Monolog Processor)需注入
tenant_id,确保每条日志可追溯归属
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











