Laravel中如何预加载Pivot模型关联以避免N+1查询？

针对你遇到的Laravel无法预加载Pivot模型关联的问题，这里提供几个可行的方案，都能避免用foreach逐个load的写法：

方案1：新增关联直接关联中间表模型 #

既然没法直接通过students关联预加载pivot的关联，不如直接给Assessment模型新增一个关联到中间表StudentAssessment的关系，然后通过这个关联预加载所有需要的内容：

// 在Assessment模型中添加以下关联
public function studentAssessments(): HasMany
{
    return $this->hasMany(StudentAssessment::class, 'assessment_id');
}

查询时直接预加载多层关联：

$assessment = Assessment::with([
    'studentAssessments.student',
    'studentAssessments.assessment_result'
])->find($yourAssessmentId);

之后你可以通过$assessment->studentAssessments获取所有包含学生信息和对应评估结果的中间表数据，所有关联都是一次性加载完成，不会触发N+1查询。

方案2：在多对多关联中手动Join关联表 #

如果你想保留原有的students关联，可以通过Join把AssessmentResult的数据直接合并到查询结果中，然后通过withPivot把需要的字段包含进来：

// 修改Assessment模型中的students关联
public function students(): BelongsToMany
{
    return $this->belongsToMany(Student::class, 'student_assessments', 'assessment_id', 'student_id')
        ->using(StudentAssessment::class)
        ->withPivot('id')
        ->join('assessment_results', 'student_assessments.id', '=', 'assessment_results.student_assessment_id')
        ->select(
            'students.*',
            'student_assessments.id as pivot_id',
            'assessment_results.*' // 可以按需指定字段，避免重名冲突
        );
}

这种方式会把评估结果的字段直接放到学生的pivot对象里，缺点是如果存在字段名重复的情况，需要手动指定别名。

方案3：利用集合批量加载关联 #

如果不想修改原有关联，也可以用集合的批量操作来预加载，写法比foreach更简洁：

// 先加载学生关联
$assessment = Assessment::with('students')->find($yourAssessmentId);

// 提取所有pivot模型的ID，批量加载对应的assessment_result关联
StudentAssessment::with('assessment_result')->findMany(
    $assessment->students->pluck('pivot.id')
);

Laravel的ORM会自动将加载好的关联附加到对应的pivot实例上，后续访问$student->pivot->assessment_result时就不会再触发新的查询了。

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