Laravel执行数据库迁移报metrics表已存在错误如何解决

• 直接触发报错的原因：执行迁移命令时，目标数据库中已经存在metrics表，Schema::create()方法尝试重复创建同名表，触发SQLSTATE[42S01]的1050错误。
• 迁移代码本身存在两处致命逻辑错误，是导致问题出现的根源：
  1. down()回滚方法逻辑完全错误：回滚迁移的作用是撤销up()方法的操作，对应建表操作的回滚应该是删除表，当前代码错误使用Schema::create()尝试建表，闭包内仅写了dropIndex(['id'])，既不符合语法逻辑，也会导致之前执行过该迁移时，回滚操作不会删除已创建的metrics表，后续重新执行迁移必然触发重复建表错误。
  2. up()方法建表逻辑不完整：当前代码中Schema::create的闭包内仅定义了id主键，但是报错SQL中显示metrics表包含value_string、value_integer、category等多个字段，说明该表已经通过之前的错误迁移、或者手动建表的方式在数据库中存在，且迁移记录表中没有对应记录，迁移执行时会判定该迁移未运行，尝试再次建表。

1. 首先修正迁移文件的代码逻辑，正确写法参考如下：

return new class extends Migration {
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('metrics', function (Blueprint $table) {
            $table->id();
            // 按业务需求补全所有表字段，和报错SQL中展示的字段对齐即可
            $table->string('value_string')->nullable();
            $table->integer('value_integer')->nullable();
            $table->float('value_float', 8, 2)->nullable();
            $table->date('value_date')->nullable();
            $table->boolean('value_boolean')->nullable();
            $table->string('category');
            $table->string('source');
            $table->boolean('availability');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        // 回滚时直接删除对应表，不要使用create方法
        Schema::dropIfExists('metrics');
    }
};

2. 清理数据库残留数据：
   • 本地开发环境下，可直接清空整个数据库，重新执行迁移命令即可
   • 不适合清空全库的场景下，手动删除数据库中已存在的metrics表，同时删除数据库migrations表中和当前迁移文件对应的记录
3. 重新执行php artisan migrate命令即可完成迁移。

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