Laravel whereIn结合orWhere搜索时失效返回非指定ID数据问题

该问题是SQL逻辑运算符优先级导致的条件生效范围异常。
你当前写法生成的原生SQL逻辑等价于：

SELECT * FROM beneficiaries 
WHERE id IN (1,2,3...) 
AND last_name LIKE '%搜索词%' 
OR first_name LIKE '%搜索词%' 
OR middle_name LIKE '%搜索词%'
LIMIT 30 OFFSET 0

SQL中AND的运算优先级高于OR，上述条件会被解析为：只要满足「id在指定范围内且姓氏匹配」、「名字匹配搜索词」、「中间名匹配搜索词」三个条件任意一个，就会被查出。后两个OR关联的搜索条件完全不受whereIn的ID范围约束，自然会返回不在指定ID数组内的数据。

核心思路是把三个模糊搜索的OR条件封装为一个独立的条件组，保证整体查询逻辑为：id必须在指定$ids数组范围内，同时满足姓氏/名字/中间名任意一个字段匹配搜索词。

• 通用兼容写法（所有Laravel版本可用）
  用闭包嵌套查询给搜索条件加逻辑括号，同时用when方法兼容无搜索关键词的场景，不需要拆分两套查询逻辑：

$benefiteds = Beneficiary::whereIn('id', $ids)
    ->when($request->filled('search'), function($query) use ($request) {
        $keyword = '%' . $request->search . '%';
        // 闭包会给内部的OR条件整体加括号，不破坏外层whereIn约束
        $query->where(function($subQuery) use ($keyword) {
            $subQuery->where('last_name', 'LIKE', $keyword)
                ->orWhere('first_name', 'LIKE', $keyword)
                ->orWhere('middle_name', 'LIKE', $keyword);
        });
    })
    ->paginate(30);

return view('pages.program_show', compact('benefiteds'), $userData)->with('program', $program);

• 简化写法（Laravel 9及以上版本可用）
  高版本Laravel自带whereAny方法，可以自动生成OR逻辑的条件组，写法更简洁：

$benefiteds = Beneficiary::whereIn('id', $ids)
    ->when($request->filled('search'), function($query) use ($request) {
        $keyword = '%' . $request->search . '%';
        $query->whereAny(['last_name', 'first_name', 'middle_name'], 'LIKE', $keyword);
    })
    ->paginate(30);

内容的提问来源于stack exchange，提问作者Faith Francis Quiman