Laravel中hasMany关联计算的最佳实践方案咨询

问题背景 #

我熟悉Laravel的Eloquent及关联关系，但在基于关联数据执行计算时，想了解这类场景的最佳实践。

现有数据表结构：

• Student：学生记录表
• StudentClass：学生班级日志表，包含student_id、class_id（关联Class模型）、status等字段
• StudentExam：学生班级科目考试记录表，包含subject_id（关联Subject模型）外键

关联关系链：Student -> StudentClass -> StudentExam -> Subject

现有StudentExam模型关联：

class StudentExam extends BaseModel
{
    // ...
    public function studentClass()
    {
        return $this->belongsTo(StudentClass::class, 'st_class_id', 'id');
    }
    // ...
}

在StudentClass模型中实现了计算学期成绩的方法：

class StudentClass extends BaseModel
{
    // ...
    public function studentExams()
    {
        return $this->hasMany(StudentExam::class, 'st_class_id', 'id');
    }

    public function semesterResult($total_credits = 0)
    {
        $credits_got = 0;
        $has_mark = 0;
        $status = 'failed';

        foreach ($this->studentExams as $exam) {
            if (($exam->total_marks ?? 0) >= $exam->success_mark) {
                $credits_got += $exam->subject->credit ?? 0;
            }
            if ($exam->mark()) $has_mark++;
        }

        if ($credits_got >= ($total_credits / 2)) $status = 'passed';

        return [
            'credits_got' => $credits_got,
            'has_mark' => $has_mark,
            'status' => $status
        ];
    }
    // ...
}

当前功能正常，但在100名学生、每人10场考试的场景下，加上关联Subject获取学分，会产生大量查询和记录加载，性能堪忧。由于多个页面需要使用这些计算结果，且后续可能扩展返回字段，希望找到更优的处理方式，最好能无需加载所有记录完成计算。

优化方案 #

1. 数据库层面聚合计算（无需加载所有记录） #

把计算逻辑转移到数据库执行，利用SQL聚合函数直接返回结果，避免加载所有StudentExam和Subject记录。可以在StudentClass模型中新增关联或方法，通过join和selectRaw实现：

class StudentClass extends BaseModel
{
    // ...

    // 获取聚合后的学期成绩统计
    public function getSemesterResultAttribute()
    {
        return $this->studentExams()
            ->join('subjects', 'student_exams.subject_id', '=', 'subjects.id')
            ->selectRaw('
                SUM(CASE WHEN student_exams.total_marks >= student_exams.success_mark THEN subjects.credit ELSE 0 END) as credits_got,
                COUNT(CASE WHEN student_exams.mark IS NOT NULL THEN 1 END) as has_mark
            ')
            ->first();
    }

    // 封装状态判断逻辑
    public function semesterResult($total_credits = 0)
    {
        $stats = $this->semester_result;
        $credits_got = $stats->credits_got ?? 0;
        $has_mark = $stats->has_mark ?? 0;
        $status = $credits_got >= ($total_credits / 2) ? 'passed' : 'failed';

        return compact('credits_got', 'has_mark', 'status');
    }
    // ...
}

这样每次调用仅执行1条聚合查询，无需加载任何StudentExam实例，性能大幅提升。

2. 预加载优化（减少N+1查询） #

如果必须加载关联记录，一定要用预加载解决N+1问题。在查询StudentClass时，同时预加载studentExams和关联的subject：

// 在控制器中查询时
$studentClasses = StudentClass::with(['studentExams.subject'])->get();

这样原本100个StudentClass会产生1+100+1000次查询，现在仅需3次查询（StudentClass、StudentExam、Subject各1次）。

3. 缓存计算结果 #

由于学期成绩不会频繁变动，可以将计算结果缓存起来，避免重复计算：

public function semesterResult($total_credits = 0)
{
    $cacheKey = "student_class_result_{$this->id}_{$total_credits}";
    
    return Cache::remember($cacheKey, now()->addDays(7), function () use ($total_credits) {
        $stats = $this->semester_result;
        $credits_got = $stats->credits_got ?? 0;
        $has_mark = $stats->has_mark ?? 0;
        $status = $credits_got >= ($total_credits / 2) ? 'passed' : 'failed';

        return compact('credits_got', 'has_mark', 'status');
    });
}

注意在成绩更新时要清除对应缓存。

4. 模型关联优化（添加统计关联） #

可以定义专门的统计关联，复用聚合逻辑：

public function studentExamStats()
{
    return $this->hasOne(StudentExam::class)
        ->join('subjects', 'student_exams.subject_id', '=', 'subjects.id')
        ->selectRaw('
            st_class_id,
            SUM(CASE WHEN student_exams.total_marks >= student_exams.success_mark THEN subjects.credit ELSE 0 END) as credits_got,
            COUNT(CASE WHEN student_exams.mark IS NOT NULL THEN 1 END) as has_mark
        ')
        ->groupBy('st_class_id');
}

查询时直接预加载这个关联：

$studentClasses = StudentClass::with('studentExamStats')->get();

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