Laravel Eloquent多when条件查询 is_donor过滤规则未生效问题

过滤失效核心是SQL运算符优先级+Eloquent条件未做分组导致的：
SQL中AND运算优先级高于OR，你直接在基础查询后链式调用orWhere，没有对搜索类的OR条件做逻辑包裹，最终生成的WHERE实际执行逻辑为：

(
  `is_donor` = 0 AND 存在关联献血记录
) 
OR 名字匹配搜索词
OR 电话匹配搜索词
OR 常住地址匹配搜索词
OR 暂住地址匹配搜索词
OR 血型匹配搜索词
OR (血型匹配搜索词 AND 关联地区匹配搜索词)

只要后面任意一个OR条件命中，不管用户is_donor值是多少、有没有献血记录，都会被返回，自然会出现is_donor=1的不符合预期的数据。

另外代码里还有两个隐藏bug：

• 地区关联查询用了whereRelation（默认AND逻辑），和前面的多个OR搜索条件组合时逻辑不符合搜索预期
• 仅传dateTo不传dateFrom时，代码里尝试解析null值的$dateFrom，会直接抛出Carbon解析错误

将所有名称、联系方式、地址、关联地区相关的OR搜索条件，全部包裹在一个嵌套where回调中，保证整个搜索条件块和外层基础过滤条件（is_donor判断、献血记录存在判断）是AND关系，同时修正关联查询和日期逻辑的问题：

public function search(Request $request)
{
    $dateFrom = $request->has("dateFrom") ? $request->get("dateFrom") : null;
    $dateTo = $request->has("dateTo") ? $request->get("dateTo") : null;
    // 可根据业务再确认此处逻辑：传status参数时筛选is_donor=0，不传则筛选is_donor=1
    $status = $request->has("status") ? 0 : 1;
    $requestName = $request->has("name") ? $request->get("name") : null;
    
    // 基础过滤条件
    $query = User::where('is_donor', $status)
        ->has("bloodDonationHistories");

    $resources = $query
        ->when($requestName, function ($q) use ($requestName) {
            // 嵌套分组包裹所有OR搜索条件，避免破坏外层基础过滤逻辑
            return $q->where(function ($subQuery) use ($requestName) {
                $subQuery->where('name', 'LIKE', '%' . $requestName . '%')
                    ->orWhere('phone', 'LIKE', '%' . $requestName . '%')
                    ->orWhere('permanent_address', 'LIKE', '%' . $requestName . '%')
                    ->orWhere('temporary_address', 'LIKE', '%' . $requestName . '%')
                    ->orWhere('blood_group', 'LIKE', '%' . $requestName . '%')
                    ->orWhereRelation('district', 'name', 'LIKE', '%' . $requestName . '%');
            });
        })
        ->when($dateFrom !== null && $dateTo !== null, function ($query) use ($dateFrom, $dateTo) {
            return $query->whereBetween('donor_verified_at', [$dateFrom, $dateTo]);
        })
        ->when($dateFrom !== null && $dateTo == null, function ($query) use ($dateFrom) {
            return $query->where('donor_verified_at', '>=', $dateFrom);
        })
        ->when($dateFrom == null && $dateTo !== null, function ($query) use ($dateTo) {
            // 修复dateFrom为null时的Carbon解析错误
            return $query->where('donor_verified_at', '<=', $dateTo);
        })
        ->paginate($this->paginationLimit);
        
    return UserResource::collection($resources);
}

修复后生成的SQL逻辑会变成：

WHERE `is_donor` = 0 
  AND EXISTS (献血记录关联判断)
  AND (
    `name` LIKE ? OR `phone` LIKE ? OR 地址匹配? OR 血型匹配? OR EXISTS (关联地区名匹配)
  )
  -- 后续日期过滤、软删除条件正常按AND拼接

完全符合预期的过滤逻辑，不会再出现绕过is_donor规则返回数据的问题。

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