Laravel迁移配置外键报150错误、参考目标字段不匹配问题

• Laravel 的 foreignId()->constrained() 方法遵循框架约定大于配置的设计逻辑：默认会自动推断关联规则，关联目标表的默认参考字段是表自带的id主键，不会自动匹配你自定义命名的非id类主键，这就是系统生成的外键默认指向sections.id、和你预期关联sections.section_id不匹配的根本原因。
• 错误码150（外键约束格式错误）还可能由两类隐藏问题触发，需要同步排查：
  • 关联字段类型不匹配：foreignId() 生成的是无符号bigint类型，你需要确认sections表中的section_id字段类型和它完全一致（比如是用bigIncrements('section_id')创建的无符号bigint主键，不能是普通int、有符号bigint），类型不匹配会直接导致约束创建失败
  • 迁移执行顺序错误：Laravel 是按迁移文件的文件名时间戳顺序执行的，必须保证创建sections表的迁移先于创建tables表的迁移执行，如果反过来先创建tables表、关联的sections表还不存在，必然触发报错

直接在constrained()方法中传入第二个参数，指定关联目标表的参考主键为section_id即可：

public function up()
{
    Schema::create('tables', function (Blueprint $table) {
        $table->bigIncrements('table_id');
        $table->string('table_number');
        // 第一个参数指定关联的表名，第二个参数指定关联的参考主键字段
        $table->foreignId('section_id')
            ->constrained('sections', 'section_id')
            ->onUpdate('cascade')
            ->onDelete('cascade');
        $table->timestamps();
        $table->softDeletes();
    });
}

• 确认sections表的迁移逻辑，检查其主键定义和tables表的section_id字段类型完全匹配
• 检查两个迁移文件的文件名时间戳，确保sections表的迁移文件时间早于tables表的迁移文件时间，避免执行顺序颠倒
• 如果之前执行过失败的迁移，先手动删除数据库中残留的不完整tables表，再重新执行迁移命令，避免表结构残留引发的冲突

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