Laravel多数据库环境下迁移与填充命令的连接问题

我之前在做类似的多学校独立数据库的Laravel项目时，也碰到过这个命令行操作绕开中间件连接切换的问题——毕竟Artisan命令不走HTTP请求流程，自然不会触发你写的中间件逻辑。给你几个实用的解决方案，按复杂度从低到高排序：

方案一：自定义Artisan命令（最推荐） #

这个方法最优雅，能完美适配你的现有逻辑：先从主库获取目标学校的数据库配置，动态加载到Laravel的配置中，再触发迁移/填充操作。

步骤1：添加动态连接模板 #

先在config/database.php里新增一个学校数据库的连接模板，后续我们会用实际学校的配置覆盖它：

'connections' => [
    // 你的超级管理员主库连接（原有的mysql配置）
    'mysql' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST'),
        'database' => env('DB_DATABASE'),
        // ... 其他主库配置
    ],
    // 学校数据库的动态连接模板
    'school_db' => [
        'driver' => 'mysql',
        'host' => '',
        'database' => '',
        'username' => '',
        'password' => '',
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'strict' => true,
    ],
],

步骤2：创建自定义命令 #

生成一个专门处理学校数据库迁移的命令：

php artisan make:command SchoolMigrate

然后修改生成的app/Console/Commands/SchoolMigrate.php文件：

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\Config;
use Illuminate\Support\Facades\DB;

class SchoolMigrate extends Command
{
    // 命令签名：接收学校ID，可选--seed参数执行填充
    protected $signature = 'school:migrate {schoolId} {--seed}';
    protected $description = 'Run migrations and seeders for a specific school\'s database';

    public function handle()
    {
        $schoolId = $this->argument('schoolId');
        
        // 从主库（默认mysql连接）获取目标学校的数据库信息
        $school = DB::connection('mysql')->table('schools')->find($schoolId);
        
        if (!$school) {
            $this->error("School with ID {$schoolId} not found in main database!");
            return 1;
        }

        // 动态覆盖school_db连接的配置
        Config::set('database.connections.school_db', [
            'driver' => 'mysql',
            'host' => $school->db_host,
            'database' => $school->db_name,
            'username' => $school->db_username,
            'password' => $school->db_password,
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            'prefix' => '',
            'strict' => true,
        ]);

        // 执行学校专属迁移（假设迁移文件放在database/migrations/school目录）
        $this->call('migrate', [
            '--database' => 'school_db',
            '--path' => database_path('migrations/school'),
            '--force' => $this->option('force'), // 支持生产环境强制执行
        ]);

        // 如果传入--seed参数，执行学校专属填充
        if ($this->option('seed')) {
            $this->call('db:seed', [
                '--database' => 'school_db',
                '--class' => 'SchoolDatabaseSeeder', // 你的学校专属填充类
            ]);
        }

        $this->info("✅ Successfully processed migrations/seeders for school #{$schoolId}");
        return 0;
    }
}

步骤3：注册命令 #

在app/Console/Kernel.php的$commands数组中注册这个命令：

protected $commands = [
    \App\Console\Commands\SchoolMigrate::class,
];

使用方式 #

现在你只需要执行这条命令，就能给指定学校的数据库执行迁移和填充了：

# 仅执行迁移
php artisan school:migrate 1

# 执行迁移+填充
php artisan school:migrate 1 --seed

方案二：在迁移/填充类中动态切换连接 #

如果你的需求比较简单，不想写自定义命令，也可以直接在迁移或填充类里手动加载学校数据库配置：

比如在迁移类中：

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Config;
use Illuminate\Support\Facades\DB;

class CreateStudentTable extends Migration
{
    protected $schoolId;

    public function __construct()
    {
        // 从环境变量或命令行输入获取学校ID
        $this->schoolId = env('SCHOOL_ID') ?? $this->ask('Please enter the school ID:');
    }

    public function up()
    {
        // 从主库获取学校配置
        $school = DB::connection('mysql')->table('schools')->find($this->schoolId);
        
        // 动态设置连接
        Config::set('database.connections.school_db', [
            // 同上的数据库配置
        ]);

        // 指定连接创建表
        Schema::connection('school_db')->create('students', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::connection('school_db')->dropIfExists('students');
    }
}

执行时通过环境变量指定学校ID：

SCHOOL_ID=1 php artisan migrate --path=database/migrations/school

方案三：借助多租户包（适合复杂项目） #

如果你的项目后续会有更多多租户（多学校）相关的需求，可以考虑使用成熟的Laravel多租户包，比如spatie/laravel-multitenancy。这类包已经内置了命令行切换租户执行迁移的功能，你只需要适配现有学校数据库的存储逻辑即可，能省不少自定义代码。

注意事项 #

• 分离迁移文件：把学校专属的迁移和主库的迁移分开存放（比如database/migrations/school目录），避免误操作主库。
• 专属填充类：为学校数据库单独写填充类，不要和主库的填充逻辑混在一起。
• 生产环境验证：在生产环境执行命令前，一定要先在测试环境验证，避免数据丢失。

内容的提问来源于stack exchange，提问作者charu