ThinkPHP 6 动态切换数据库连接需通过 Db::setConnectConfig() 注册唯一标识连接配置，并在模型查询时显式调用 connect('identifier') 或通过基类 __callStatic 自动注入租户连接，避免 Db::connect() 临时调用无效、硬编码 $connection 属性或跨租户事务。
ThinkPHP 6 的 Db::connect() 不支持运行时动态切换连接池
直接调用 Db::connect(['hostname' => 'xxx']) 确实能创建新连接，但这个连接不会自动注入到当前请求的查询链路中——后续所有 Db::table()、Model::find() 仍走默认连接。这不是 bug，是设计使然：ThinkPHP 的连接管理基于「连接标识 + 连接池」机制，而非每次查询都新建连接。
真正有效的动态切换，必须在连接初始化阶段就绑定唯一标识，并确保整个请求生命周期内复用该标识。多租户场景下，租户 ID 通常来自域名、请求头或路由参数，需在应用启动早期（如中间件）完成连接注册与全局绑定。
- 不要在控制器里反复调用
Db::connect()并试图“覆盖”默认连接 - 避免把连接配置硬编码进模型的
$connection属性——它只读取一次，不响应运行时变化 - 若租户数量大（如上千），别为每个租户预定义完整连接配置数组，应按需生成并缓存
用 Db::setConnectConfig() + 自定义连接标识实现租户隔离
ThinkPHP 6.1+ 提供了 Db::setConnectConfig() 方法，允许在运行时注册带标识的新连接配置，再通过 Db::name()->connect('tenant_123') 显式指定使用。这是目前最稳妥的动态方案。
典型做法是在全局中间件中解析租户标识（例如从子域名提取），生成连接配置，并注册：
// app/middleware/TenantDbMiddleware.php
public function handle($request, \Closure $next)
{
$tenantId = $this->resolveTenantId($request); // 如：subdomain.tld → tenant_123
$config = [
'type' => 'mysql',
'hostname' => config('database.tenant_host'),
'database' => 'db_' . $tenantId,
'username' => config('database.tenant_user'),
'password' => config('database.tenant_pass'),
'hostport' => 3306,
];
Db::setConnectConfig('tenant_' . $tenantId, $config);
// 绑定到 Request 或容器，供后续逻辑获取
$request->withAttr('tenant_id', $tenantId);
return $next($request);
}
- 连接标识（如
'tenant_123'）必须全局唯一且稳定，建议与租户 ID 强一致 -
Db::setConnectConfig()是幂等的，重复注册同标识不会报错，但也不会刷新已有连接对象；如有密码/库名变更，需先Db::close('tenant_123') - 模型查询时务必显式指定连接：
UserModel::connect('tenant_123')->where('id', 1)->find()，否则仍走默认库
模型层如何避免硬编码连接标识？用 __callStatic 动态代理
每个模型手动写 connect('tenant_xxx') 很容易漏，也不利于维护。更合理的做法是重写模型基类的静态调用逻辑，在 find、select 等方法触发前自动补上当前租户连接。
示例基类（app/model/TenantModel.php）：
class TenantModel extends Model
{
public static function __callStatic($method, $args)
{
if (in_array($method, ['get', 'all', 'find', 'select', 'count', 'value'])) {
$tenantId = request()->attr('tenant_id');
if ($tenantId) {
return self::connect('tenant_' . $tenantId)->$method(...$args);
}
}
return parent::__callStatic($method, $args);
}
}
- 该方案依赖中间件已将
tenant_id写入request()，否则会 fallback 到默认连接 - 不拦截
new static()或构造函数调用，仅对静态查询方法生效；插入/更新仍需显式调用save()前确认连接 - 注意事务：跨租户事务不可行，
Db::transaction()只作用于单个连接标识，不能混用多个tenant_xxx
连接泄漏与超时问题：Db::close() 不是万能的
高频租户切换（如 API 网关场景）下，若不主动清理，连接池可能堆积大量闲置连接，最终耗尽 MySQL 的 max_connections。但直接在请求结束时调用 Db::close('tenant_123') 有风险——ThinkPHP 的连接池内部引用计数未暴露，强行关闭可能影响其他并发请求中同标识的连接复用。
更安全的做法是控制连接池大小 + 启用空闲回收：
- 在数据库配置中设置
'deploy' => 0（禁用读写分离）、'pool_size' => 5（限制每租户最多 5 连接） - 启用连接空闲检测：
'break_reconnect' => true，配合 MySQL 的wait_timeout自动断开长期空闲连接 - 真正需要释放时，用
Db::instance('tenant_123')->close()，而非Db::close('tenant_123')，前者操作具体实例，后者清空整个标识下的所有实例缓存
租户连接的“动态”本质是配置驱动的标识切换，不是连接对象的实时替换。最容易被忽略的是：模型继承链中任何一处遗漏 connect() 调用，或中间件未正确注入 tenant_id，都会导致数据跨库写入——这种错误在线上往往静默发生，直到报表对不上才暴露。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
