连接名必须在config/database.php的connections数组中真实存在且拼写完全一致；db::connection()仅获取实例，需链式调用查询方法才生效；$connection属性静态绑定模型连接，on()方法临时覆盖；事务必须显式指定连接名或使用连接实例调用。
连接名必须在 config/database.php 的 connections 数组里真实存在，且调用时拼写完全一致——大小写、下划线、空格都不能错。
DB::connection() 临时切换连接要链式执行
调用 DB::connection('mysql_log') 只是拿到一个连接实例，它本身不触发任何查询。如果你只写这一行就结束，什么都不会发生，也不会报错，但逻辑就断了。
- ✅ 正确写法：
DB::connection('mysql_log')->table('logs')->insert([...]) - ❌ 错误写法：
DB::connection('mysql_log');（后面没接查询） - ⚠️ 常见陷阱：在 if 分支里写了
DB::connection('backup')，但忘记加 ->select() 或 ->update()，结果查的还是 default 连接
模型中 $connection 属性是静态绑定，on() 是运行时覆盖
$connection = 'pgsql_archive' 写死在模型里，所有该模型的查询（包括 find()、where()->get()、save()）都走这个连接，连事务也自动绑定过去；而 User::on('mysql_backup')->first() 只影响这一次查询，下次调用又回到默认或模型指定的连接。
- 静态绑定适合长期隔离场景，比如日志表、租户库、归档库
-
on()适合偶尔切库的临时操作，比如导出时读备份库、迁移时写测试库 - 如果模型已设
$connection，再调on()会覆盖它；但如果没设，on()就是唯一入口
事务必须显式指定连接，否则默认走 .env 的 DB_CONNECTION
DB::transaction() 不管模型有没有设 $connection，默认只作用于 DB_CONNECTION 环境变量指定的那个连接。想让事务跑在 mysql_secondary 上，必须明确告诉它：
- Laravel 9.x+：
DB::transaction(fn () => ..., 5, 'mysql_secondary') - 通用写法：
DB::connection('mysql_secondary')->transaction(fn ($db) => {...}) - 别混用：
DB::transaction()包裹一个设置了$connection = 'pgsql_reporting'的模型操作——事务仍可能落在 default 库上
报错 InvalidArgumentException: Database [xxx] not configured 怎么排查
这个错误只说明一件事：你传给 DB::connection() 或 on() 的字符串，在 config/database.php 的 connections 数组里找不到对应键名。
- 检查
config/database.php是否真的定义了'mysql_log' => [...]，而不是'mysql-log'或'log_mysql' - 确认没有拼错，比如
'mysql_lgo'或大小写混淆（Laravel 连接名区分大小写） - 运行
php artisan config:clear，避免缓存旧配置 - 用
dd(array_keys(config('database.connections')))直接看当前加载了哪些连接名
最易被忽略的是：事务和模型连接是两套独立机制，$connection 不会自动让 DB::transaction() 切过去，必须手动指定连接名或用连接实例调用 transaction()。
