Laravel迁移新增pivot表关联外键时报1822错误问题排查

MySQL外键约束强制要求：被引用的字段必须在对应表上存在可独立命中的索引。
你当前的landlord_agreements是双字段复合主键表，主键组为(landlords_id, agreements_id)，InnoDB的复合索引遵循最左匹配原则：

• 只有复合索引最左侧的landlords_id可以单独被外键引用
• 排在第二位的agreements_id无法单独命中复合主键索引，也没有其他独立索引，因此抛出1822缺少索引的错误。
  你之前创建外键能正常运行，是因为之前引用的都是单字段主键，单字段主键自带独立索引，不会触发这个问题。
  另外你写的pivot表迁移存在语法顺序问题：主键定义放在了字段声明之前，执行时会报字段不存在错误，需要把字段声明移到主键、索引定义之前。

根据实际业务场景选一种即可：

• 方案1：保留单字段外键关联逻辑，给被引用字段加独立索引
  修改pivot表迁移代码，给agreements_id添加普通索引，修正后的代码：

Schema::create('landlord_agreements', function (Blueprint $table) {
    // 先定义字段，再定义主键、索引
    $table->unsignedBigInteger('landlords_id');
    $table->unsignedBigInteger('agreements_id');
    $table->string('created_by');
    $table->string('updated_by')->nullable();
    $table->timestamps();
    $table->softDeletes();

    // 主键和索引定义放在字段声明之后
    $table->primary(['landlords_id', 'agreements_id']);
    $table->index('agreements_id'); // 新增独立索引满足外键要求
});

第二张表的迁移代码不需要修改，重新执行迁移即可成功。

• 方案2：如果需要严格关联pivot表的唯一记录，创建复合外键
  单字段无法唯一确定复合主键表的一条记录，如果业务上需要强一致性关联，不能只关联agreements_id，需要在第二张表同时存两个主键字段，创建复合外键，代码如下：

Schema::table('property_chqeque_first_rows', function (Blueprint $table) {
    $table->unsignedBigInteger('landlords_id')->after('id')->nullable();
    $table->unsignedBigInteger('agreements_id')->after('landlords_id')->nullable();
    // 字段顺序和pivot表复合主键顺序保持一致
    $table->foreign(['landlords_id', 'agreements_id'])
        ->references(['landlords_id', 'agreements_id'])
        ->on('landlord_agreements');
});

注意：复合外键的字段顺序必须和被引用表的复合主键/索引顺序完全一致，否则还是会报缺少索引错误。
这种写法不需要给agreements_id单独加索引，外键顺序和复合主键顺序一致即可命中索引。

• 方案3：取消数据库层面外键约束，仅保留业务关联字段
  如果不需要数据库强制做关联数据一致性校验，可以直接删掉外键定义，只保留landlord_agreement_id字段，业务层自己做关联逻辑即可。这种方案没有外键的性能开销，也不会出现约束报错，是中大型项目的常见实践。

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