Laravel中能否在Eloquent查询中使用Pivot类关联？

问题1：能否预加载pivot关联（如pivot.offer）？ #

可以预加载自定义Pivot类的关联，前提是已完成正确的配置：

1. 定义自定义Pivot类并添加关联

use Illuminate\Database\Eloquent\Relations\Pivot;

class UserSubject extends Pivot
{
    public function offer()
    {
        return $this->belongsTo(Offer::class);
    }
}

2. 在User模型的关联中指定使用该Pivot类

// User模型
public function subjects()
{
    return $this->belongsToMany(Subject::class)
        ->using(UserSubject::class) // 指定自定义Pivot类
        ->withPivot('offer_id'); // 携带中间表的offer_id字段（可选，需直接访问字段时添加）
}

3. 执行预加载
   查询时通过嵌套关联语法预加载pivot的关联数据：

// 预加载用户的科目及对应pivot关联的Offer
$user = User::with('subjects.pivot.offer')->find($userId);

// 访问示例
foreach ($user->subjects as $subject) {
    $offerType = $subject->pivot->offer->type;
}

问题2：是否可以在查询构建器中使用Pivot类的关联？ #

你给出的示例写法无法直接生效——whereRelation('pivot.offer')是在Subject模型的查询构建器上调用的，但pivot并非Subject模型的关联。以下是两种正确实现方式：

方法1：使用wherePivotHas方法（推荐） #

Laravel的belongsToMany关联提供了wherePivotHas方法，专门用于针对中间表的关联进行过滤：

use Illuminate\Database\Eloquent\Builder;

$users = User::query()
    ->whereHas('subjects', function (Builder $query) use ($subjectName, $offerType) {
        $query->where('name', $subjectName)
            ->wherePivotHas('offer', function (Builder $offerQuery) use ($offerType) {
                $offerQuery->where('type', $offerType);
            });
    })
    ->get();

方法2：手动关联中间表与Offer表 #

通过join语句直接关联中间表和Offer表，实现相同过滤逻辑：

$users = User::query()
    ->join('user_subject', 'users.id', '=', 'user_subject.user_id')
    ->join('offers', 'user_subject.offer_id', '=', 'offers.id')
    ->join('subjects', 'user_subject.subject_id', '=', 'subjects.id')
    ->where('subjects.name', $subjectName)
    ->where('offers.type', $offerType)
    ->select('users.*')
    ->distinct() // 避免重复用户记录
    ->get();

实现hasSubject方法示例 #

结合上述逻辑，在User模型中实现你需要的检查方法：

public function hasSubject(string $subjectName, string $offerType): bool
{
    return $this->subjects()
        ->where('name', $subjectName)
        ->wherePivotHas('offer', fn($q) => $q->where('type', $offerType))
        ->exists();
}

调用方式：

$hasMathOnline = $user->hasSubject(Subject::MATH, Offer::TYPE_ONLINE);

内容的提问来源于stack exchange，提问作者Gaël Duval