本文详解 Laravel 数据库迁移中外键创建失败（errno 150）的根本原因与解决方案，重点说明主键与外键字段类型必须严格匹配（如 bigIncrements ↔ unsignedBigInteger），并提供可直接复用的迁移代码和最佳实践。

本文详解 laravel 数据库迁移中外键创建失败（errno 150）的根本原因与解决方案，重点说明主键与外键字段类型必须严格匹配（如 `bigincrements` ↔ `unsignedbiginteger`），并提供可直接复用的迁移代码和最佳实践。

在 Laravel 中为数据表添加外键时，若遇到 SQLSTATE[HY000]: General error: 1005 Can't create table ... (errno: 150 "Foreign key constraint is incorrectly formed") 错误，几乎总是由外键列与被引用主键列的数据类型不一致导致——这是 MySQL 强制要求的底层约束，而非 Laravel 框架缺陷。

? 核心原则：类型必须完全匹配

Laravel 的 id() 方法默认等价于 bigIncrements('id')（即 UNSIGNED BIGINT AUTO_INCREMENT PRIMARY KEY）。因此，所有引用该主键的外键字段必须声明为 unsignedBigInteger，且不能遗漏 ->unsigned()（即使 unsignedBigInteger() 已隐含，显式调用更安全）：

// ✅ 正确：students 表使用 id() → 对应外键必须是 unsignedBigInteger
Schema::create('exams', function (Blueprint $table) {
    $table->id();
    $table->unsignedBigInteger('student_id')->nullable();   // ← 关键：类型严格匹配
    $table->unsignedBigInteger('subject_id')->nullable();   // ← 同理
    $table->integer('mark');
    $table->timestamps();

    // 建立外键约束（推荐显式命名以利维护）
    $table->foreign('student_id')
          ->references('id')
          ->on('students')
          ->onDelete('cascade'); // 可选：级联删除

    $table->foreign('subject_id')
          ->references('id')
          ->on('subjects')
          ->onDelete('cascade');
});

而你的原始代码中：

$table->BigInteger('student_id')->unsigned()->nullable(); // ❌ BigInteger ≠ unsignedBigInteger

BigInteger() 默认为有符号（signed） 类型，与 id() 生成的 UNSIGNED BIGINT 不兼容，直接触发 errno 150。

✅ 正确迁移顺序与注意事项

1. 确保被引用表已存在且结构稳定
   students 和 subjects 表必须在 exams 迁移之前完成创建，且其 id 字段必须为 bigIncrements() 或 increments()（不可手动改为 id() 以外的类型）。

2. 统一主键定义风格（强烈推荐）
   在 Laravel 8+ 中，所有新表应统一使用 id()（即 bigIncrements），外键则统一用 unsignedBigInteger()：

   // students migration
   Schema::create('students', function (Blueprint $table) {
       $table->id(); // ≡ bigIncrements('id')
       $table->string('fname');
       $table->string('mname');
       $table->string('lname');
       $table->timestamps();
   });
   
   // subjects migration
   Schema::create('subjects', function (Blueprint $table) {
       $table->id();
       $table->string('title');
       $table->timestamps();
   });

3. 若需兼容旧项目（使用 increments）
   若 students 表主键为 increments()（即 UNSIGNED INTEGER），则外键必须改为：

   $table->unsignedInteger('student_id')->nullable();

4. 启用外键检查（开发环境建议）
   在 AppServiceProvider@boot 中临时启用严格模式（仅开发）：

   use Illuminate\Support\Facades\DB;
   DB::statement('SET FOREIGN_KEY_CHECKS = 1');

?️ 排查与修复步骤

• ✅ 运行 php artisan migrate:fresh --seed 清空重试（确保无残留表）；
• ✅ 使用 php artisan schema:dump 查看当前表结构是否符合预期；
• ✅ 检查 MySQL 存储引擎：外键仅支持 InnoDB，确认迁移中未意外指定 ENGINE=MyISAM；
• ✅ 验证字符集一致性：students、subjects、exams 三表均应使用相同 charset（如 utf8mb4）和 collation。

? 终极提示：Laravel 9+ 支持 foreignId() 快捷方法，语义更清晰且自动匹配类型：

$table->foreignId('student_id')->nullable()->constrained()->onDelete('cascade');

它会自动推断为 unsignedBigInteger 并关联 students.id，大幅降低出错概率。

遵循以上规范，即可彻底规避 errno 150 错误，构建健壮、可维护的数据库关系结构。