Laravel如何基于event_id和player_imported_id创建联合外键

现有表结构 #

event_player_lists表 #

Schema::create('event_player_lists', function (Blueprint $table) {
    $table->id();
    $table->foreignId('event_id')->constrained('events')->cascadeOnDelete();
    $table->unsignedInteger('player_imported_id')->index();
    $table->string('role', 50);
    $table->timestamps();
});

event_winner_players表 #

Schema::create('event_winner_players', function (Blueprint $table) {
    $table->id();
    $table->foreignId('event_id')->constrained('events')->cascadeOnDelete();
    $table->unsignedInteger('player_imported_id');
    $table->string('vote')->nullable();
    $table->float('point');
    $table->foreign('player_imported_id')->references('player_imported_id')->on('event_player_lists')->cascadeOnDelete();
    $table->timestamps();
});

问题描述 #

当前event_winner_players仅通过player_imported_id单字段关联event_player_lists，但不同赛事的player_imported_id可能重复。删除某赛事（如ID=3）的玩家列表记录时，所有拥有相同player_imported_id的获胜玩家记录都会被级联删除，不符合仅删除对应赛事获胜记录的需求。

错误尝试 #

曾尝试创建复合外键，但因缺少必要索引导致SQL错误：

$table->foreign(['player_imported_id', 'event_id'])
    ->references(['player_imported_id', 'event_id'])
    ->on('event_player_lists')
    ->onDelete('NO ACTION');

正确解决方案 #

要创建复合外键，需先确保被关联表（event_player_lists）的event_id和player_imported_id字段存在联合唯一索引——因为外键关联的字段必须是主键或唯一索引。

步骤1：给event_player_lists添加联合唯一索引 #

创建新的迁移文件，执行以下代码：

Schema::table('event_player_lists', function (Blueprint $table) {
    // 添加联合唯一索引，确保同一赛事下的玩家ID唯一
    $table->unique(['event_id', 'player_imported_id']);
});

注意：若现有数据中存在同一赛事下重复的player_imported_id，需先清理数据再执行此迁移，否则会创建索引失败。

步骤2：修改event_winner_players的外键关联 #

创建新的迁移文件，先删除原有的单字段外键，再添加复合外键：

Schema::table('event_winner_players', function (Blueprint $table) {
    // 删除原有的单字段外键（外键名称可通过数据库查看具体值）
    $table->dropForeign(['player_imported_id']);
    
    // 添加复合外键，设置级联删除
    $table->foreign(['event_id', 'player_imported_id'])
        ->references(['event_id', 'player_imported_id'])
        ->on('event_player_lists')
        ->onDelete('cascade');
});

效果验证 #

完成上述迁移后，删除event_player_lists中某赛事的记录时，只会级联删除event_winner_players中同一赛事+同一玩家ID的对应记录，不会影响其他赛事的数据。

内容的提问来源于stack exchange，提问作者T. Ikbal