Laravel迁移中如何检测外键与字段存在以避免重复执行报错

外键存在性检测支持说明 #

Laravel本身完全支持外键存在性检测，可直接在迁移文件中加入判断逻辑避免重复创建/删除外键的报错。

适配方案 #

• Laravel 9及以上版本：可直接使用Schema门面自带的hasForeignKey()方法，方法接收两个参数：表名、外键名。
  Laravel默认生成的外键命名规则为表名_字段名_foreign，如果你创建外键时自定义了外键名，判断时传入自定义的名称即可。你的场景下示例代码如下：

// 添加外键前判断
if (!Schema::hasForeignKey('articles', 'articles_blog_category_id_foreign')) {
    $table->foreign('blog_category_id')
        ->references('id')
        ->on('blog_categories')
        ->onDelete('set null');
}

删除外键时也可以加上对应判断，避免删除不存在的外键时报错：

// 删除外键和字段前判断
if (Schema::hasForeignKey('articles', 'articles_blog_category_id_foreign')) {
    $table->dropForeign(['blog_category_id']);
}
if (Schema::hasColumn('articles', 'blog_category_id')) {
    $table->dropColumn('blog_category_id');
}

• Laravel 8及更早版本：没有内置hasForeignKey()方法，可通过两种方式处理：
  • 用try-catch包裹外键操作逻辑，捕获SQL执行异常跳过报错
  • 直接查询数据库information_schema表判断外键是否存在

1050表已存在报错说明 #

你收到的SQLSTATE[42S01]: Base table or view already exists: 1050 Table 'articles' already exists报错和外键判断无关，本质是迁移执行记录与数据库实际表结构不同步导致的：你清空数据库时仅删除了表内数据没有删除表本身，同时清空了migrations迁移记录表，Laravel执行迁移时会从最早的迁移步骤开始运行，执行到创建articles表的迁移时发现表已存在就会抛出报错。
本地开发环境下直接执行php artisan migrate:fresh即可解决，该命令会自动删除所有表后重新执行全量迁移。

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