Laravel中如何存储同一用户同一角色但分属不同公司的关联关系

嘿，这个问题我之前也踩过坑！Laravel默认的sync()方法确实会把user_id和role_id当成联合唯一标识来处理，所以相同的用户-角色组合就会被覆盖掉，没办法存不同公司的记录。不过别担心，咱们通过调整关联定义和使用正确的方法就能解决这个问题！

第一步：调整关联表的联合主键 #

首先你得确保role_user表的联合主键包含三个字段：user_id、role_id、company_id。因为只有这三个字段组合起来才是唯一的，不然数据库层面也会阻止你插入重复的组合。你可以在迁移文件里这样修改：

Schema::create('role_user', function (Blueprint $table) {
    $table->unsignedBigInteger('user_id');
    $table->unsignedBigInteger('role_id');
    $table->unsignedBigInteger('company_id');
    
    // 把三个字段设为联合主键
    $table->primary(['user_id', 'role_id', 'company_id']);
    
    // 别忘了添加外键约束
    $table->foreign('user_id')->references('id')->on('users')->onDelete('cascade');
    $table->foreign('role_id')->references('id')->on('roles')->onDelete('cascade');
    $table->foreign('company_id')->references('id')->on('companies')->onDelete('cascade');
});

第二步：修改模型的关联定义 #

Laravel默认的多对多关联只认两个外键，所以咱们得在模型里明确告诉它要带上company_id这个额外字段。

在User模型里修改roles关联：

public function roles()
{
    return $this->belongsToMany(Role::class)
                ->withPivot('company_id') // 带上company_id字段
                ->withTimestamps(); // 如果表有时间戳字段的话加上
}

同样，在Role模型里修改users关联：

public function users()
{
    return $this->belongsToMany(User::class)
                ->withPivot('company_id')
                ->withTimestamps();
}

第三步：用正确的方法替换sync() #

现在默认的sync()已经不适用了，因为它只会对比user_id和role_id。咱们可以根据需求选择下面的方法：

1. 新增关联（不删除已有记录）

如果你只是想添加新的用户-角色-公司关联，直接用attach()就行，把每个组合作为数组传进去：

$user = User::find(1);
// 添加用户1在公司1和公司2的角色1关联
$user->roles()->attach([
    ['role_id' => 1, 'company_id' => 1],
    ['role_id' => 1, 'company_id' => 2],
]);

2. 确保关联存在（不删除已有，也不重复添加）

如果你想确保某些关联存在，但又不想删除现有的其他关联，可以用syncWithoutDetaching()，注意要把每个唯一组合拆开来传递：

$user->roles()->syncWithoutDetaching([
    1 => ['company_id' => 1],
    1 => ['company_id' => 2],
]);

要是担心数组键重复的问题，直接用上面多维数组形式的attach()更稳妥（Laravel 8+支持这种写法）。

3. 替换所有关联（先删再加）

如果你想完全替换用户的所有角色关联，比如更新用户在各个公司的角色，那可以先清空现有关联，再重新添加：

$user = User::find(1);
// 先删除所有关联
$user->roles()->detach();
// 再添加新的关联组合
$user->roles()->attach([
    ['role_id' => 1, 'company_id' => 1],
    ['role_id' => 1, 'company_id' => 2],
    ['role_id' => 2, 'company_id' => 1],
]);

为啥默认sync()不行？ #

简单说，Laravel的sync()方法内部是通过user_id和role_id这两个字段来匹配记录的，当这两个值相同时，它会认为是同一条记录，所以会执行更新而不是插入。而咱们的场景需要三个字段的组合才是唯一的，所以必须调整关联和使用合适的方法。

备注：内容来源于stack exchange，提问作者satik-stack