Laravel迁移添加外键遭遇Error 1025错误，求助排查与解决

问题场景 #

在Laravel项目中尝试为mahasiswa表添加关联prodi表和jurusan表的外键，迁移代码如下：

public function up()
{
    Schema::table('mahasiswa', function (Blueprint $table) {
        // 添加不存在的字段
        if (!Schema::hasColumn('mahasiswa', 'prodi_id')) {
            $table->unsignedBigInteger('prodi_id')->nullable();
        }

        if (!Schema::hasColumn('mahasiswa', 'jurusan_id')) {
            $table->unsignedBigInteger('jurusan_id')->nullable();
        }

        // 添加外键约束
        $table->foreign('prodi_id')->references('id')->on('prodi')->onDelete('restrict')->onUpdate('restrict');
        $table->foreign('jurusan_id')->references('id')->on('jurusan')->onDelete('restrict')->onUpdate('restrict');
    });
}

运行迁移时触发错误：

SQLSTATE[HY000]: General error: 1025 Error on rename of '.\ta\#sql-2b2c_56b' to '.\ta\mahasiswa' (errno: 150 "Foreign key constraint is incorrectly formed")

已确认prodi和jurusan表存在，主键id类型与外键字段类型一致，仍无法解决问题。

排查与解决思路 #

1. 检查表的字符集和排序规则是否一致 #

MySQL要求关联的表必须使用相同的字符集和排序规则，否则会触发外键约束错误。可以通过以下SQL查询确认：

SHOW CREATE TABLE mahasiswa;
SHOW CREATE TABLE prodi;
SHOW CREATE TABLE jurusan;

如果字符集（如utf8mb4）或排序规则（如utf8mb4_unicode_ci）不一致，需要修改表结构统一。比如修改mahasiswa表的字符集：

ALTER TABLE mahasiswa CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2. 确认关联表主键的类型完全匹配 #

即使都是整数类型，也要确认prodi和jurusan表的id是否为unsignedBigInteger。如果旧表使用的是unsignedInteger（32位无符号整数），那么mahasiswa表的外键字段也需要改成unsignedInteger，而不是unsignedBigInteger（64位）。

3. 清理现有数据中的无效外键值 #

如果mahasiswa表中已存在prodi_id或jurusan_id数据，且这些值在关联表中不存在，添加外键时会失败。可以用以下SQL查询找出无效数据：

SELECT * FROM mahasiswa 
WHERE prodi_id NOT IN (SELECT id FROM prodi) 
OR jurusan_id NOT IN (SELECT id FROM jurusan);

找到后要么删除这些记录，要么将无效的外键值改为NULL（因为外键字段设置为nullable）。

4. 拆分迁移步骤 #

将添加字段和添加外键的操作拆分成两个独立的迁移文件，避免在同一个表操作闭包中同时修改字段和添加约束导致的表结构更新不及时问题：

迁移1：仅添加外键字段

public function up()
{
    Schema::table('mahasiswa', function (Blueprint $table) {
        if (!Schema::hasColumn('mahasiswa', 'prodi_id')) {
            $table->unsignedBigInteger('prodi_id')->nullable();
        }

        if (!Schema::hasColumn('mahasiswa', 'jurusan_id')) {
            $table->unsignedBigInteger('jurusan_id')->nullable();
        }
    });
}

public function down()
{
    Schema::table('mahasiswa', function (Blueprint $table) {
        $table->dropColumn(['prodi_id', 'jurusan_id']);
    });
}

迁移2：添加外键约束

public function up()
{
    Schema::table('mahasiswa', function (Blueprint $table) {
        $table->foreign('prodi_id')
              ->references('id')
              ->on('prodi')
              ->onDelete('restrict')
              ->onUpdate('restrict');

        $table->foreign('jurusan_id')
              ->references('id')
              ->on('jurusan')
              ->onDelete('restrict')
              ->onUpdate('restrict');
    });
}

public function down()
{
    Schema::table('mahasiswa', function (Blueprint $table) {
        $table->dropForeign(['prodi_id', 'jurusan_id']);
    });
}

5. 手动指定外键名称避免冲突 #

如果之前尝试添加外键失败，可能残留了重复的约束名。可以手动指定外键名称来避免冲突：

$table->foreign('prodi_id', 'mahasiswa_prodi_fk')
      ->references('id')
      ->on('prodi')
      ->onDelete('restrict')
      ->onUpdate('restrict');

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