如何实现ThinkPHP多租户SaaS系统的数据库隔离_动态切换Db配置与前置解析-ThinkPHP-PHP中文网

thinkphp多租户动态切换数据库需在全局中间件中用db::setconnectconfig()替换默认配置，并立即调用db::clearconnectionpool()清空连接池，同时严格清洗tenant_id生成合法database名，三者缺一不可。

如何实现thinkphp多租户saas系统的数据库隔离_动态切换db配置与前置解析

直接原因：ThinkPHP 的 Db::connect() 默认返回新连接实例，但模型（Model 或 Db 门面）后续调用仍走默认连接池，不会自动绑定你手动 connect 的实例。

典型错误写法：Db::connect('tenant_a')->table('users')->select() 看似切换了，实际执行时可能还是用的默认配置里的数据库。

必须显式把动态连接“挂载”到当前请求上下文——推荐在中间件中用 Db::setConnectConfig() 替换全局默认配置
若用 Db::connect($config)，需全程用该实例链式调用，不能混用 Db::table() 这类门面静态方法
注意连接配置中的 database 字段必须是完整库名（如 tenant_123），不能只传前缀
TP6.1+ 支持 Db::connect()->useConfig($name)，但前提是 $name 已在 database.php 中预定义（不适合运行时千变万化的租户库）

前置解析的核心是「在任何模型操作前确定租户身份」，这个动作必须早于路由调度和控制器初始化。

常见误区是等进到控制器才去取 tenant_id，此时 Db 连接可能已按默认配置建好，再切就晚了。

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

下载

最佳位置是全局中间件（如 app/middleware/TenantResolve.php），且需注册为 before 类型（TP6 中叫 middleware 数组首位）
优先从 header 取（如 request()->header('X-Tenant-ID')），比 URL 参数或子域名更安全、不易被伪造
若用子域名（tenant1.example.com），解析逻辑必须在 App::init() 后立即执行，避免路由模块提前加载模型
务必校验租户 ID 合法性（比如查 sys_tenants 表是否存在且启用），非法值应直接中断，不要 fallback 到默认库

TP 的 database 配置项最终会传给 PDO，它对库名有严格要求：不能含特殊字符、不能超长、不能以数字开头（MySQL 规则）。

很多团队用租户 UUID 或邮箱做标识，直接拼进去会导致 PDO 连接失败，报错类似：SQLSTATE[HY000] [1049] Unknown database 'tenant@abc.com'。

建议统一用正则清洗：preg_replace('/[^a-zA-Z0-9_]/', '_', $tenantId)，再加前缀如 'tenant_' . $safeId
MySQL 库名最大长度 64 字符，清洗后仍超长要截断并哈希（如 substr(md5($tenantId), 0, 8)）
不要在配置里写死 hostname 或 username ——这些通常全租户共用，只需动态改 database 和 host（如分片时指向不同物理机）
测试时用 Db::getConfig() 打印当前生效配置，确认 database 值是否符合预期