Laravel关联查询疑问：whereHas闭包内可执行操作范围不明

嘿，我来帮你理清楚这个whereHas闭包里能做、不能做的事情，结合你的Student-Exam一对多场景来说明：

首先，你要明白这个闭包的本质 #

这个闭包的作用是给关联模型（这里是Exam）添加查询约束，闭包里的$query是Exam模型的查询构造器实例，所有操作都是围绕Exam的字段和查询规则来的。

✅ 闭包里可以做的操作 #

• 基础的字段筛选：直接用where、orWhere等方法筛选Exam的字段，这正是你需要的：

  $query->where('name', 'English');
  

• 多条件链式调用：可以组合多个条件，比如筛选出参加过English且分数及格的学生：

  $query->where('name', 'English')->where('score', '>=', 60);
  

• 复杂逻辑分组：用嵌套闭包处理OR/AND的组合逻辑，比如筛选参加过English或English Writing考试的学生：

  $query->where(function($subQuery) {
      $subQuery->where('name', 'English')
               ->orWhere('name', 'English Writing');
  });
  

• 原生SQL条件：用whereRaw处理一些复杂的原生查询，比如忽略大小写匹配：

  $query->whereRaw('LOWER(name) = ?', ['english']);
  

• 嵌套关联筛选：如果Exam还有其他关联（比如ExamCategory），你甚至可以在闭包里继续用whereHas嵌套：

  $query->whereHas('category', function($catQuery) {
      $catQuery->where('type', 'language');
  });
  

• 按关联记录数量筛选：在whereHas的第三个参数指定比较符，第四个参数指定数量，比如筛选参加过至少2次English考试的学生：

  Student::whereHas('Exams', function($query) {
      $query->where('name', 'English');
  }, '>=', 2)->get();
  

❌ 闭包里不能做的操作 #

• 直接操作主模型（Student）的字段：闭包的上下文是Exam的查询构造器，不能直接引用Student的字段（比如$query->where('students.age', 18)），如果需要关联主模型字段，得手动join，但whereHas本身已经帮你处理了关联，所以只需要专注于Exam的字段即可。
• 调用主模型的实例方法：闭包里的$this是查询构造器对象，不是Student实例，所以不能用$this->name这类写法。
• 执行查询的方法：不要在闭包里用get()、first()、pluck()这类会直接执行查询的方法，这会提前触发关联查询，破坏整个主查询的构建。
• 返回值：这个闭包不需要返回任何值，你只需要修改$query对象即可，Laravel会自动处理后续的查询逻辑。

给你的最终可用代码 #

结合你的需求，补全后的代码应该是这样的：

$english_students = Student::with('Exams')
    ->whereHas('Exams', function($query) {
        // 筛选出名称为"English"的考试记录
        $query->where('name', 'English');
    })
    ->get();

这样就能准确获取所有参加过English考试的学生啦～

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