需在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 或时间敏感业务中容易出错。

# mysql  # default  # table  # database  # 数据库  # 多个  # 链式  # 复用  # 也会  # 键名  # 两种  # 三种  # 问题是  # 定了  # protected  # 字符串  # php  # word  # laravel  # cad  # 编码  # app  # 环境变量  # 配置文件  # 键值对  # 中间件  # 常量  # count  # pdo  # 绑定