直接修改模型的$connection属性或使用on()方法可切换Eloquent数据库连接，但需在查询前设置且不自动继承关联，配置错误、缓存未清或事务跨库均会导致失败。
如何在运行时切换 Eloquent 模型的数据库连接
直接改 $connection 属性是最常用也最可靠的方式，但必须在查询发起前设置，且不能跨查询复用。Laravel 不会自动“记住”你临时切过的连接，每次新查询都得重新指定或重置。
- 在模型实例上设：
$user = new User(); $user->setConnection('mysql2'); $user->find(1); - 在模型类上设（影响后续所有静态调用）：
User::on('mysql2')->find(1)，等价于临时覆盖$connection并返回新查询构造器 - 注意：使用
on()后，关联查询默认仍走原模型的$connection，不会自动继承——这是最容易漏掉的点 - 如果想让整个链路（包括
with()关联）都走同一连接，得手动为关联模型也指定连接，比如在User的posts()关系里加return $this->hasMany(Post::class)->on('mysql2');
为什么 config/database.php 里配了多个连接，但 Model::on('xxx') 还是报错 “Database [xxx] not configured”
常见原因是配置未加载或键名不一致。Laravel 在启动时读取 config/database.php，但如果你在运行时动态修改了配置（比如用 Config::set()），Eloquent 的连接解析器并不会自动感知——它只认原始配置快照。
- 检查
config/database.php中'connections'数组下是否存在对应键，例如'mysql2' => [ ... ] - 确认没拼错：大小写敏感，
'mysql-two'和'mysql2'是两个不同连接 - 执行
php artisan config:clear，避免缓存旧配置（尤其在 .env 修改后没清缓存） - 验证是否生效：运行
dd(config('database.connections.mysql2'))，看输出是否为完整数组而非null
事务跨连接是否可行？DB::transaction() 能否包裹多个数据库的操作
不能。Laravel 的 DB::transaction() 底层只作用于单个连接实例，传入的闭包里所有 DB::table() 或模型操作，若未显式指定连接，全走默认连接；即使你手动切了模型连接，事务本身也不会跨库生效。
- MySQL 原生不支持跨库事务（除非用 XA，但 Laravel 完全不封装这一层）
- 常见替代方案：用单库事务 + 应用层补偿逻辑，或者拆成多个独立事务，靠业务状态字段+定时任务兜底
- 如果硬要“伪原子”，可先在连接 A 写入，再在连接 B 写入，失败时手动回滚 A —— 但这不是 ACID 事务，只是尽力而为
- 别依赖
DB::connection('mysql2')->transaction(...)来协调两个库，它只锁住mysql2那一个连接
连接切换对查询构建器和原始 SQL 的影响差异
DB::table() 默认走 config('database.default')，而模型走自己的 $connection；但一旦用了 on() 或 setConnection()，两者行为就趋同——关键在于“谁持有连接实例”。
立即学习“PHP免费学习笔记（深入）”；
-
DB::connection('mysql2')->table('users')->get()：明确指定连接，安全 -
DB::table('users')->on('mysql2')->get()：语法合法，但易混淆——on()是查询构建器方法，不是全局切换 -
DB::select('SELECT * FROM users', [], 'mysql2')：错误！DB::select()不接受第三个连接参数，必须用DB::connection('mysql2')->select(...) - 原始语句中表名不带库前缀（如
mysql2.users）时，完全依赖当前连接指向的数据库，跟配置名无关
实际项目里最麻烦的不是切连接，而是连接复用时的状态残留——比如一个请求中先查 mysql1，再查 mysql2，中间没清理连接状态，某些驱动（尤其是 PDO 长连接）可能复用旧连接句柄。建议在多连接场景下，显式管理连接生命周期，而不是依赖框架自动回收。
