Laravel迁移中如何避免重复创建外键？

你的现有代码只做了表存在性判断，但没检查外键是否已经存在，所以重复执行迁移时还是会尝试创建已存在的外键，导致数据库抛出"外键已存在"的错误。下面给你几种简便的实现方式：

方法一：直接判断外键是否存在（Laravel 8+） #

Laravel从8.x版本开始提供了hasForeign方法，可以直接检查表的指定外键是否存在。修改你的代码如下：

// 处理mymuesli_label表的外键
if (Schema::connection('orders_import')->hasTable('mymuesli_label') && 
    !Schema::connection('orders_import')->hasForeign('roll_id')) {
    Schema::connection('orders_import')->table('mymuesli_label', function (Blueprint $table) {
        $table->foreign(['roll'], 'roll_id')
              ->references(['id'])
              ->on('mymuesli_roll');
    });
}

// 处理parameter_mapping表的外键
if (Schema::connection('orders_import')->hasTable('parameter_mapping') && 
    !Schema::connection('orders_import')->hasForeign('parameter_mapping_fk_customer')) {
    Schema::connection('orders_import')->table('parameter_mapping', function (Blueprint $table) {
        $table->foreign(['customer'], 'parameter_mapping_fk_customer')
              ->references(['id_customer'])
              ->on('customer');
    });
}

// 处理product_mapping表的外键
if (Schema::connection('orders_import')->hasTable('product_mapping') && 
    !Schema::connection('orders_import')->hasForeign('product_mapping_fk_customer')) {
    Schema::connection('orders_import')->table('product_mapping', function (Blueprint $table) {
        $table->foreign(['customer'], 'product_mapping_fk_customer')
              ->references(['id_customer'])
              ->on('customer');
    });
}

核心是新增了!Schema::connection('orders_import')->hasForeign('外键名称')的判断，确保只有外键不存在时才执行创建逻辑。

方法二：封装成辅助函数减少重复代码 #

如果需要处理的外键较多，可以封装一个通用函数，避免重复写判断逻辑：

/**
 * 仅当外键不存在时添加外键
 * @param string $connection 数据库连接名
 * @param string $table 目标表名
 * @param array $columns 外键字段
 * @param string $foreignKeyName 外键约束名称
 * @param string $referencedTable 关联表名
 * @param array $referencedColumns 关联字段
 */
function addForeignIfNotExists($connection, $table, $columns, $foreignKeyName, $referencedTable, $referencedColumns)
{
    $schema = Schema::connection($connection);
    if ($schema->hasTable($table) && !$schema->hasForeign($foreignKeyName)) {
        $schema->table($table, function (Blueprint $table) use ($columns, $foreignKeyName, $referencedTable, $referencedColumns) {
            $table->foreign($columns, $foreignKeyName)
                  ->references($referencedColumns)
                  ->on($referencedTable);
        });
    }
}

// 调用示例
addForeignIfNotExists(
    'orders_import',
    'mymuesli_label',
    ['roll'],
    'roll_id',
    'mymuesli_roll',
    ['id']
);

addForeignIfNotExists(
    'orders_import',
    'parameter_mapping',
    ['customer'],
    'parameter_mapping_fk_customer',
    'customer',
    ['id_customer']
);

addForeignIfNotExists(
    'orders_import',
    'product_mapping',
    ['customer'],
    'product_mapping_fk_customer',
    'customer',
    ['id_customer']
);

这样代码更简洁，后续新增外键时直接调用函数即可。

注意事项 #

• 确保你使用的Laravel版本支持hasForeign方法（Laravel 8及以上），如果是更低版本，可以通过查询数据库系统表来判断外键是否存在（比如MySQL的information_schema.KEY_COLUMN_USAGE表）。
• 外键名称必须唯一，这也是为什么你的代码里指定了自定义外键名，这一步很重要，否则hasForeign无法准确判断。

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