Laravel迁移报错1215：无法添加外键约束（自关联表场景）

这个问题我之前也碰到过，核心原因是外键字段和关联字段的数据类型不匹配——InnoDB对自关联外键的字段类型一致性要求非常严格，咱们一步步来看怎么解决：

问题根源 #

你定义的id字段用了bigIncrements()，这对应MySQL里的BIGINT UNSIGNED AUTO_INCREMENT类型，但parent_id用的是integer()->unsigned()，也就是INT UNSIGNED类型。两种类型的长度和存储范围不一样，InnoDB会拒绝创建这种不匹配的外键约束，这就是你看到SQLSTATE[HY000]: General error: 1215错误的原因。

解决方案 #

方案1：创建表时直接定义正确的字段类型

把parent_id的类型改成和id匹配的unsignedBigInteger()，修改后的迁移代码如下：

Schema::create('categories', function (Blueprint $table) { 
    $table->bigIncrements('id'); 
    $table->string('name'); 
    // 使用unsignedBigInteger匹配bigIncrements的类型
    $table->unsignedBigInteger('parent_id')->nullable()->default(null); 
    $table->foreign('parent_id')->references('id')->on('categories'); 
    $table->timestamps(); 
});

直接运行这个迁移就能成功创建带自关联外键的表。

方案2：针对已创建的表修改

如果已经创建了原结构的表，需要分两步调整：

1. 先修改parent_id的字段类型，匹配id的类型：

Schema::table('categories', function (Blueprint $table) {
    // 先删除原有的parent_id字段
    $table->dropColumn('parent_id');
    // 添加正确类型的字段
    $table->unsignedBigInteger('parent_id')->nullable()->default(null);
});

2. 再添加外键约束：

Schema::table('categories', function (Blueprint $table) {
    $table->foreign('parent_id')->references('id')->on('categories');
});

额外提醒 #

以后定义外键的时候一定要注意：外键字段和它引用的字段必须完全一致，包括数据类型、是否无符号、甚至字符集（如果是字符串类型的话），InnoDB在这方面的校验非常严格。

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