ThinkPHP多租户数据隔离_ThinkPHP数据库架构设计方法【解答】-ThinkPHP-PHP中文网

租户识别必须在中间件中完成且置于队列首位，需在请求初期解析host或http头获取租户id，绑定到request实例，确保数据库连接、缓存、日志等全部组件基于该id隔离，杜绝后续环节二次解析。

thinkphp多租户数据隔离_thinkphp数据库架构设计方法【解答】

租户识别必须在中间件里做，且要放在队列最前面

租户识别不是“配个路由”或“写个配置”就能生效的事——它必须在请求刚进来、任何模型、日志、缓存、数据库连接都还没初始化时就完成。常见错误是把识别逻辑塞进控制器或服务类，结果 Db::connect() 已经用默认配置连上库，baseQuery 还没执行，App::instance()->tenant 也还没绑定。

实操建议：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 app/middleware/CheckTenant.php 中读取 $_SERVER['HTTP_HOST']（反向代理下优先检查 $_SERVER['HTTP_X_FORWARDED_HOST']），不依赖 request()->domain()，避免 URL 重写干扰
该中间件必须置于 app/middleware.php 的中间件队列首位，确保早于路由解析和控制器实例化
租户 ID 绑定到 think\Request 实例更稳妥：$request->tenantId = $tenantId，后续模型、服务都能通过 app('request')->tenantId 取值
子域名需白名单校验，比如只允许 preg_match('/^([a-z0-9\-]+)\.example\.com$/', $host, $matches)，防伪造 Host 头

Db::connect() 动态切换连接前必须清池或改键

Db::connect() 内部用静态数组缓存连接实例，键名默认是配置数组的 MD5。多个租户若只改了 database 名而其他字段（host、username、charset）完全一致，MD5 就会撞车，导致复用旧连接——这是最隐蔽的数据串查来源。

实操建议：

切换租户前必须调用 Db::clearConnectPool()，但注意这会清空所有连接，影响并发性能
更优解是绕过 Db::connect()，直接 new think\db\Connection，把租户库名作为构造参数透传
若坚持用 Db::connect()，请在配置数组中加入唯一字段，例如 'tenant_id' => $tenantId，并重写 think\db\Connection::getPoolKey() 方法，把 tenant_id 显式纳入键生成逻辑
所有模型强制指定 protected $connection = 'tenant';，避免意外走默认连接

模型层 tenant_id 过滤不能只靠 baseQuery

baseQuery() 能拦截 find()、select()、update()，但对 count()、sum()、max() 等聚合查询无效——它们绕过模型生命周期，直通查询构造器。软删除字段叠加后更容易漏条件，典型现象是 User::where('status', 1)->count() 返回 0，实际数据存在。

实操建议：

基类模型中封装 tenantCount() 方法，内部强制走完整链路：return $this->db()->table($this->getTable())->where('tenant_id', $this->getTenantId())->where(...)->count();
全局作用域（addGlobalScope()）比 baseQuery() 更底层，但 count() 默认也不触发；必须配合 useGlobalScope(true) 显式启用
关联查询（with()）不继承主模型的租户条件，需在关联定义里手动加 ->where('tenant_id', $this->tenantId)，或改用 hasWhere()
禁止在模型中调用 session() 或 cookie() 获取租户 ID——CLI、队列任务中 session 根本不存在

缓存、Session、日志必须带租户上下文

即使数据库和模型都隔离了，如果缓存键没加租户前缀，cache('user_list') 就可能被不同租户共享；Session 名称若固定为 PHPSESSID，用户在多个租户间切换会互相覆盖；日志里不打租户 ID，排查问题时根本分不清是哪个租户出的问题。

实操建议：

缓存键统一拼接：cache('tenant_' . app('request')->tenantId . '_user_list')，或重写 think\Cache 的 getCacheKey()
Session 名称动态设置：config(['session.name' => 'sess_' . app('request')->tenantId])，并在中间件中调用 session()->start() 前完成
日志处理器中注入租户 ID：Log::channel('daily')->write('info', 'xxx', ['tenant_id' => app('request')->tenantId])
所有第三方 SDK（如 Redis 客户端、消息队列 Producer）初始化时，都应将租户 ID 作为上下文透传，避免异步任务丢失隔离边界

租户 ID 的可信来源只有一个：中间件从请求头或 Host 解析出的结果。任何后续环节（模型、服务、命令行、定时任务）都不能再二次解析或 fallback 到 session、cookie、URL 参数——这些在非 HTTP 场景下根本不可用，强行使用只会让隔离在某个环节彻底失效。