需在config/database.php的connections数组中手动添加多个连接配置，每个连接需唯一键名并完整定义驱动及凭证字段，通过模型$connection属性、DB::connection()或链式connection()方法动态切换，注意事务不跨连接、避免硬编码连接名、迁移和Seeder需显式指定--database参数。
配置多个数据库连接需修改 config/database.php
Laravel 默认只配一个 mysql 连接，要支持多个，得在 connections 数组里手动加键值对。每个连接必须有唯一键名（比如 mysql_tenant_a、pgsql_reporting），且完整定义 driver、host、database、username、password 等字段。
环境变量建议用不同前缀区分，例如：
DB_TENANT_A_HOST=10.0.1.10 DB_TENANT_A_DATABASE=tenant_a DB_TENANT_B_HOST=10.0.1.11 DB_TENANT_B_DATABASE=tenant_b
然后在 config/database.php 中引用：
'mysql_tenant_a' => [
'driver' => 'mysql',
'url' => env('DATABASE_URL'),
'host' => env('DB_TENANT_A_HOST', '127.0.0.1'),
'database' => env('DB_TENANT_A_DATABASE', 'forge'),
'username' => env('DB_TENANT_A_USERNAME', 'root'),
'password' => env('DB_TENANT_A_PASSWORD', ''),
// ... 其他字段保持一致
],
运行时动态切换连接的三种方式
不能靠改配置文件实时生效，必须在代码中显式指定连接。Laravel 提供了三类入口：
- 模型层面：在 Eloquent 模型类里设
$connection属性，如protected $connection = 'mysql_tenant_a'; - 查询构造器层面：用
DB::connection('mysql_tenant_b')->table(...) - 查询链路层面：在
DB::table(...)->connection('mysql_tenant_c')后追加connection()方法（注意：该方法仅在 9.x+ 支持，8.x 需升级或改用前两种）
特别注意：事务跨连接不生效。如果 DB::connection('a')->transaction() 里调用了 DB::connection('b') 的操作，后者不在事务保护内。
连接名硬编码是最大隐患，推荐用服务容器绑定
直接写死 'mysql_tenant_a' 字符串会导致散落在各处、难维护、易拼错。更稳妥的做法是把连接名抽象成常量或服务标识：
在 app/Providers/AppServiceProvider.php 的 boot() 中注册：
use Illuminate\Support\Facades\DB;
$this->app->bind('db.tenant.a', function () {
return DB::connection('mysql_tenant_a');
});
$this->app->bind('db.reporting', function () {
return DB::connection('pgsql_reporting');
});
之后 anywhere 可以：
$tenantDb = app('db.tenant.a');
$tenantDb->table('users')->get();
这样既解耦连接名字符串，又便于后续统一替换驱动或加中间件（比如自动注入租户 ID 到查询条件）。
多连接下迁移和 Seeder 的坑
php artisan migrate 默认只跑 default 连接，要指定连接得加 --database=xxx 参数：
php artisan migrate --database=mysql_tenant_a php artisan db:seed --database=pgsql_reporting
Seeder 类里如果没显式指定连接，也会走默认连接。务必检查所有 Model::factory()->count(10)->create() 调用是否绑定了正确连接，否则数据可能写进错库。
另一个隐形问题是连接复用：Laravel 默认复用 PDO 实例，但不同连接之间不共享状态（比如字符集、时区）。如果某个连接设置了 SET time_zone = '+08:00'，它不会影响其他连接——这点在跨库 JOIN 或时间敏感业务中容易出错。
