ThinkPHP模型配置详解：多数据库连接下模型的动态切换与指定【方法】

在ThinkPHP里，让一个模型不再死磕单一数据库，而是根据业务需求灵活切换连接，这事儿的核心在于：你得搞明白“配置定义”和“运行时指定”是两码事。光改个配置文件，模型可不会自己学会分身术。

先说个关键点。很多时候，大家以为把数据库连接配好了，模型就能自动切换。但实际开发中，模型与数据库的绑定方式，决定了你的代码是灵活还是僵硬。下面这几种方案，覆盖了从最稳定到最动态的常见场景。

模型类里直接绑定固定连接

最简单也最稳妥的方式，适用于读写分离、主从库、或者独立的日志库这类连接关系长期不变的场景。你只需要在模型类顶部加一个 protected $connection 属性，值填上 config/database.php 里 connections 数组对应的键名就行。

比如你配了个 'mysql_read' => [...]，那模型里就写 protected $connection = 'mysql_read';。这个设置只在模型首次加载时读一次，之后不会跟着运行时配置变。所有 find()、sa ve()、delete() 操作都走这个连接，包括关联查询——但得注意，关联模型要是没单独设 $connection，它还是走自己的默认连接，不会自动继承父模型的设置。

控制器中临时切换连接（Db::connect）

适合单次查询、数据迁移、后台导出这类偶发性的跨库操作，不改变模型的默认行为。操作很简单：

用 Db::connect('mysql_log') 拿到一个独立的 Query 实例，一定要赋值给一个变量，比如 $logDb = Db::connect('mysql_log');。然后用这个变量执行查询，比如 $logDb->table('user_action')->where('uid', 100)->select();。注意，别把 Db::table() 或 Model::find() 跟这个变量混着用，它们还是走默认连接，跟 $logDb 完全是两码事。

这一步虽然简单，但连接名一定要写对。大小写不对、漏掉下划线，都会抛出 Connection not found 异常，ThinkPHP 8 在这点上查得特别严。

多租户场景下动态注册连接并注入模型

当租户 ID 来自子域名或请求头时，你就没法在模型里写死 $connection 了。必须在请求生命周期的早期，完成连接的注册和模型的绑定。

方法一：中间件注册 + 请求属性透传

在全局中间件里解析租户标识（比如从 sub.tld 提取出 tenant_a），生成对应的数据库配置数组，调用 Db::setConnectConfig('tenant_a', $config) 注册。然后把租户 ID 绑定到 Request 对象上，供后续模型读取。这样，模型在需要的时候就能根据请求信息找到对应的数据库连接。

方法二：基类重写 __callStatic 自动注入

创建一个 BaseModel，重写它的 __callStatic 方法。在调用 find()、sa ve() 等静态方法之前，先检查 Request 里有没有 tenant_id，有的话就自动追加 ->connect('tenant_' . $id)。需要注意的是，Db::setConnectConfig 是幂等的，重复注册同一个标识不会刷新已有的连接对象。如果租户密码变了，得先 Db::close('tenant_a') 再重新注册。

方法三：服务容器绑定租户专用模型实例

在服务提供者里，根据当前租户 ID 动态 new UserModel(['connection' => 'tenant_' . $id])，然后把实例注入到容器中。控制器里通过 app(UserModel::class) 拿到的，就是已经绑定好对应数据库连接的模型实例了。