Laravel多数据库迁移异常：shibbir_DB1未创建projects表

核心原因 #

php artisan migrate:fresh --seed 仅对默认数据库连接生效：它会清空默认库的所有表（包括migrations迁移记录表），然后重新执行迁移并填充种子数据。但对于shibbir_DB1这类自定义连接，该命令不会处理其migrations表，也不会删除其中的现有表。

这就导致了两种矛盾现象：

• 保留if (!Schema::connection('shibbir_DB1')->hasTable('projects'))判断时：shibbir_DB1的migrations表中可能已有该迁移的执行记录，或者之前的表删除操作未同步更新hasTable的判断结果，导致代码跳过表创建；
• 移除判断后：shibbir_DB1中projects表实际并未被migrate:fresh删除，因此执行创建语句时触发“表已存在”的SQL错误。

可行解决方案 #

方案1：针对每个连接单独执行迁移命令 #

这是最符合Laravel迁移规范的方式，分别处理每个数据库连接：

1. 先处理默认数据库：

   php artisan migrate:fresh --seed
   

2. 再依次处理自定义连接，使用--database参数指定目标连接：

   # 处理shibbir_DB1
   php artisan migrate:fresh --database=shibbir_DB1
   # 处理shibbir_DB2
   php artisan migrate:fresh --database=shibbir_DB2
   # 处理shibbir_DB3
   php artisan migrate:fresh --database=shibbir_DB3
   

   如果需要给自定义连接执行种子数据，可单独运行：

   php artisan db:seed --database=shibbir_DB1
   

方案2：拆分迁移文件，每个连接对应独立迁移 #

为每个数据库连接创建单独的迁移文件，让Laravel自动跟踪每个连接的迁移状态：

• 生成默认连接的迁移：

  php artisan make:migration create_projects_table
  

• 生成shibbir_DB1的迁移（指定--database参数）：

  php artisan make:migration create_projects_table --database=shibbir_DB1
  

  同理为shibbir_DB2、shibbir_DB3创建对应迁移文件，在每个迁移文件的up/down方法中，无需手动指定连接（Laravel会自动关联到创建时指定的连接）。

方案3：修复当前迁移的判断逻辑（不推荐） #

如果一定要在单个迁移中处理多连接，需手动维护自定义连接的迁移状态，但这种方式容易导致迁移记录混乱：

public function up()
{
    // 针对shibbir_DB1，先清空迁移记录（谨慎操作，会丢失该连接的所有迁移历史）
    Schema::connection('shibbir_DB1')->table('migrations', function ($table) {
        $table->truncate();
    });
    
    // 再创建表，无需hasTable判断
    Schema::connection('shibbir_DB1')->create('projects', function (Blueprint $table) {
        $table->id();
        // 其他字段定义
        $table->timestamps();
    });

    // 处理默认连接和其他自定义连接的逻辑
    Schema::create('projects', function (Blueprint $table) {
        $table->id();
        // 其他字段定义
        $table->timestamps();
    });

    Schema::connection('shibbir_DB2')->create('projects', function (Blueprint $table) {
        $table->id();
        // 其他字段定义
        $table->timestamps();
    });

    Schema::connection('shibbir_DB3')->create('projects', function (Blueprint $table) {
        $table->id();
        // 其他字段定义
        $table->timestamps();
    });
}

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