如何正确编写带关联查询、orWhere及分页的Laravel Eloquent搜索代码？

API 探路者

2026-8-17

问题分析与修复方案

核心问题

你代码里的错误在于先调用了get()方法——这会直接执行SQL查询并返回Eloquent集合，之后的where/orWhere都是在内存里过滤集合，而非在数据库层面执行搜索，而且paginate()方法不能用于集合，直接导致搜索逻辑完全失效。另外直接拼接字符串构造like条件存在SQL注入风险，需要用参数绑定规避。

正确代码写法

$data = Teamuser::join('teams', 'teams.id', '=', 'team_user.team_id')
    ->join('users', 'users.id', '=', 'team_user.user_id')
    ->select([
        'users.name as username',
        'teams.name',
        'users.email',
        'team_user.role',
        'team_user.id',
        'team_user.user_id',
        'team_user.team_id'
    ])
    // 仅当搜索参数存在时才添加搜索条件
    ->when($request->search2, function ($query) use ($request) {
        $searchTerm = "%{$request->search2}%";
        $query->where(function ($subQuery) use ($searchTerm) {
            $subQuery->where('users.name', 'like', $searchTerm)
                ->orWhere('teams.name', 'like', $searchTerm)
                ->orWhere('team_user.role', 'like', $searchTerm)
                ->orWhere('users.email', 'like', $searchTerm);
        });
    })
    ->paginate(5);