生产环境手动加列后，如何解决Laravel迁移的重复列错误？

方法1：修改迁移文件，添加列存在判断 #

直接在迁移的up方法中加入列存在检查，只在列不存在时执行创建操作，完全不影响现有数据。

示例代码：

public function up()
{
    Schema::table('目标表名', function (Blueprint $table) {
        // 逐个检查需要添加的列
        if (!Schema::hasColumn('目标表名', '新列1')) {
            $table->string('新列1')->nullable();
        }
        if (!Schema::hasColumn('目标表名', '新列2')) {
            $table->integer('新列2')->default(0);
        }
        // 其他需要添加的列同理
    });
}

这种方法的优势是：既解决了当前生产环境的迁移报错，又能保证测试、新部署的生产实例等后续环境可以正常通过迁移创建列，维持环境一致性。

方法2：手动标记迁移为已执行（适合迁移内容与手动添加列完全一致的场景） #

Laravel通过migrations表记录已执行的迁移，如果你确认迁移文件中定义的列和手动添加的列完全一致（类型、默认值、约束等都相同），可以直接将该迁移记录插入到migrations表，让Laravel认为它已经执行过。

操作步骤：

1. 找到你的迁移文件名，比如2024_05_20_123456_add_new_columns_to_target_table.php，提取文件名中时间戳加名称的部分：2024_05_20_123456_add_new_columns_to_target_table
2. 执行SQL插入语句（替换对应的值）：

INSERT INTO migrations (migration, batch) VALUES ('2024_05_20_123456_add_new_columns_to_target_table', (SELECT MAX(batch) FROM migrations) + 1);

执行后再运行php artisan migrate就不会再报错了。

方法3：统一列定义（适合手动添加的列与迁移定义有差异的场景） #

如果手动添加的列和迁移文件中的定义不一致（比如类型错误、默认值不符），可以先检查列是否存在，再用change方法调整列定义，同时兼容列已存在的情况。

注意：使用change方法需要先安装依赖包：

composer require doctrine/dbal

示例代码：

public function up()
{
    Schema::table('目标表名', function (Blueprint $table) {
        if (Schema::hasColumn('目标表名', '新列1')) {
            // 调整列定义为迁移中预期的状态
            $table->string('新列1')->nullable()->change();
        } else {
            // 列不存在时创建
            $table->string('新列1')->nullable();
        }
    });
}

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