Laravel 8.x Eloquent数据库迁移正确外键约束语法及1215报错原因

报错根因 #

你遇到的Cannot add foreign key constraint（1215错误），核心原因是两个关联字段的数据类型不兼容：

• users表的主键通过$table->id()生成，Laravel 默认定义的是 BIGINT UNSIGNED 类型的自增列（8字节长度）。
• items表中你定义的user_id字段是 $table->integer('user_id')->unsigned()，对应MySQL的 INT UNSIGNED 类型（4字节长度）。

MySQL 建立外键时强制要求关联字段的类型、长度、无符号属性完全一致，类型不匹配就会直接抛出这个错误。你在phpMyAdmin手动操作时没有报错，是因为手动选择的字段类型刚好和users表的主键匹配，和你迁移文件中的字段定义没有关系。

修正后的代码 #

你当前的写法把建表、加外键拆成了两次数据库操作，完全可以在同一次建表逻辑里完成，用Laravel 内置的foreignId方法可以自动匹配主键类型，避免手动写类型时的错漏：

// items 表迁移文件的核心逻辑
public function up()
{
    Schema::create('items', function (Blueprint $table) {
        $table->id();
        // 自动生成与users表id完全匹配的bigint unsigned类型字段
        $table->foreignId('user_id')
            // 自动关联users表的id主键
            ->constrained()
            // 可选：配置删除用户时同步删除关联条目
            ->onDelete('cascade');
        $table->string('itemName');
        $table->string('itemDescription');
        $table->timestamps();
    });
}

// down 方法不需要额外处理外键，框架会自动在删表时解除关联
public function down()
{
    Schema::dropIfExists('items');
}

如果你坚持不用快捷方法，要手动定义外键，只需要把原有的integer('user_id')->unsigned()替换为bigInteger('user_id')->unsigned()，保证和users表的id类型完全一致，就能正常创建外键，不需要额外拆分Schema::table的操作。

额外注意事项 #

• 迁移执行顺序：Laravel 按照迁移文件名的时间戳顺序执行任务，子表（items）的迁移时间必须晚于父表（users），否则会出现被关联表不存在的报错，从你贴的运行日志看当前顺序是符合要求的。
• 如果之前已经执行过部分失败的迁移，需要先回滚已执行的items表创建操作（执行php artisan migrate:rollback），再重新运行修正后的迁移命令，否则会因为表已存在报错。
• 回滚时如果遇到外键相关错误，检查是否存在删除父表时子表外键还未解除的问题，用foreignId+constrained的写法可以自动处理回滚时的外键删除逻辑，不需要手动编写删除约束的代码。

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