如何更新User、Bag、Book三模型的多对多关联关系？

问题根源 #

你当前用的BelongsToMany是两两多对多的关联设计，只适配两个外键的中间表，但你的中间表有user_id/bag_id/book_id三个复合外键。sync()方法是基于关联模型ID（比如bag_id）去重同步的，同一个bag_id只会保留一条记录，自然没法实现一个Bag对应多个Book的需求。

正确实现方案 #

1. 定义自定义中间模型 #

创建中间表对应的模型（比如UserBagBook），直接操作这个三元关联表：

namespace App\Models;

use Illuminate\Database\Eloquent\Relations\Pivot;

class UserBagBook extends Pivot
{
    // 指定中间表名，需与数据库表名一致
    protected $table = 'user_bag_book';
    // 复合主键无需自增ID
    public $incrementing = false;
    // 定义复合主键
    protected $primaryKey = ['user_id', 'bag_id', 'book_id'];
}

2. 更新User模型的关联定义 #

把原来的两两关联替换为与中间模型的hasMany关联（也可保留原关联作为补充）：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use App\Models\UserBagBook;

class User extends Model
{
    // 直接关联三元中间模型，核心操作依赖这个关联
    public function userBagBooks()
    {
        return $this->hasMany(UserBagBook::class);
    }

    // 可选：保留与Bag/Book的两两关联，方便查询
    public function bags()
    {
        return $this->belongsToMany(Bag::class, 'user_bag_book')
                    ->withPivot('book_id')
                    ->distinct();
    }

    public function books()
    {
        return $this->belongsToMany(Book::class, 'user_bag_book')
                    ->withPivot('bag_id')
                    ->distinct();
    }
}

3. 执行关联更新操作 #

方式一：全量替换（清空旧关联，插入新关联）

适合需要完全覆盖旧关联的场景：

// 删除该用户所有旧的三元关联记录
$user->userBagBooks()->delete();

// 插入新的关联数据，按需求构造条目即可
$user->userBagBooks()->createMany([
    ['bag_id' => 1, 'book_id' => 1],
    ['bag_id' => 2, 'book_id' => 1],
    ['bag_id' => 2, 'book_id' => 2],
    // 可继续添加更多关联条目
]);

方式二：增量更新（添加/删除指定关联）

如果只需要修改部分关联，无需全量替换：

// 添加一条新关联
$user->userBagBooks()->create(['bag_id' => 2, 'book_id' => 3]);

// 删除指定关联（比如删除用户的bag1关联的book1）
$user->userBagBooks()
     ->where('bag_id', 1)
     ->where('book_id', 1)
     ->delete();

补充说明 #

如果一定要用sync()方法，只能针对单一的两两关联（比如只同步用户的Bag，忽略Book），但这不符合你的多关联需求，因此自定义中间模型是适配三元多对多场景的最优方案。

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