Laravel Eloquent子查询过滤学生列表异常问题排查

原代码存在的问题 #

1. 筛选条件互斥：使用else if导致三个筛选条件只能生效一个，比如同时传地区和科目时，只会执行地区筛选，完全不符合多条件组合筛选的需求。
2. 嵌套数组错误：科目筛选时写了[$request->subjects]，如果前端传的是[201,205]，这里就变成了[[201,205]]，属于嵌套数组，直接触发Nested arrays may not be passed to whereIn method错误。
3. 子查询错误调用get()：子查询里加了get()会直接执行查询并返回集合，但whereIn需要的是一个查询构造器实例，不是查询结果，这会导致SQL语法错误，也是单个科目时返回空的核心原因。

优化后的代码 #

方案一：修复原查询逻辑

$students = Student::query()
    ->when($request->location, function ($query) use ($request) {
        $query->whereIn('location', $request->location);
    })
    ->when($request->gender, function ($query) use ($request) {
        $query->where('gender', $request->gender);
    })
    ->when($request->subjects, function ($query) use ($request) {
        $query->whereIn('id', function($subjectQuery) use ($request) {
            $subjectQuery->select('student_id')
                ->from('student_subjects')
                ->whereIn('subject_id', $request->subjects);
        });
    })
    ->get();

方案二：用Eloquent关联简化（更推荐）

先在Student模型中定义与关联表的关系：

// Student.php
public function subjects()
{
    return $this->belongsToMany(Subject::class, 'student_subjects');
}

然后查询代码可以简化为：

$students = Student::query()
    ->when($request->location, fn($q) => $q->whereIn('location', $request->location))
    ->when($request->gender, fn($q) => $q->where('gender', $request->gender))
    ->when($request->subjects, fn($q) => $q->whereHas('subjects', fn($subQ) => $subQ->whereIn('id', $request->subjects)))
    ->get();

优化点说明 #

• 用when()替代原生if判断，代码更简洁，符合Eloquent的写法习惯。
• 移除了互斥的else if，支持多个筛选条件同时生效。
• 修复了科目筛选的嵌套数组问题，直接传入$request->subjects。
• 删除了子查询中的get()，让Eloquent正确拼接子查询语句。
• 方案二的关联查询可读性更高，后续维护成本更低。

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