Laravel使用Eloquent查询构造器按关联教师姓名搜索学校的解决方案

问题原因 #

你的原有写法存在三处核心错误：

1. 变量名不匹配：初始化的查询构造器是$schools，后续调用方法误用了未定义的$questions变量。
2. 字段名错误：Teacher模型的可填充字段为name，whereHas闭包内使用的teacher_name是不存在的字段。
3. 逻辑优先级混乱：未将所有并列的搜索条件放到同一个分组闭包中，SQL中AND优先级高于OR，会导致最终执行的查询逻辑不符合预期。

修复后的查询代码 #

public function index(Request $request)
{
    $schools = School::query();

    // 用户搜索词
    $search = $request->get('search');
    $headTeacher = $request->get('head_teacher');

    $schools
        ->when($search, function ($q) use ($search) {
            // 所有OR条件放入同一个分组，避免逻辑优先级错乱
            $q->where(function ($query) use ($search) {
                $query->where('school_name', 'like', '%' . $search . '%')
                    ->orWhere('head_teacher', 'like', '%' . $search . '%')
                    ->orWhereHas('teachers', function($q) use ($search) {
                        // 使用Teacher表实际存在的name字段
                        $q->where('name', 'like', '%' . $search . '%');
                    });
            });
        })
        // 后续追加的其他条件不会被前面的OR逻辑影响
        ->when($headTeacher, function ($q) use ($headTeacher) {
            $q->where('head_teacher', $headTeacher);
        })
        ->get();
}

性能优化方案 #

• 给teacher表的name字段、schools表的school_name和head_teacher字段添加普通索引，提升匹配效率；如果业务允许去掉左模糊匹配（即不用%xxx格式），索引利用率会更高，否则建议改用全文索引或Elasticsearch做全文检索。
• 给中间表teacher_links的school_id和teacher_id添加联合索引，加速关联查询速度。
• 搜索量较大的场景可将学校与关联教师的信息做冗余存储到专用搜索表，避免每次查询都关联多表。

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