在 laravel 查询中，orwhere 会与前面的 where 条件形成 or 关系，导致关键过滤条件（如状态、空值判断）被绕过；正确做法是用闭包进行逻辑分组，将 orwhere 封装在独立的括号内，确保搜索条件不干扰主查询约束。

在 laravel 查询中，orwhere 会与前面的 where 条件形成 or 关系，导致关键过滤条件（如状态、空值判断）被绕过；正确做法是用闭包进行逻辑分组，将 orwhere 封装在独立的括号内，确保搜索条件不干扰主查询约束。

Laravel 的查询构建器默认按顺序拼接 where 和 orWhere，但它们的优先级等同于 SQL 中的扁平化 AND/OR——即 A AND B OR C AND D，而非直观的 A AND B AND (C OR D)。这正是问题根源：原始代码中：

->where('borrowers.borrower_name', 'like', '%'.$search.'%')
->orWhere('borrowers.IC', 'like', '%'.$search.'%')
->where('borrows.late_return_status', '=', 1)
->where('borrows.return_date', '=', null)

实际生成的 SQL 等价于：

WHERE borrowers.borrower_name LIKE ? 
   OR borrowers.IC LIKE ? 
   AND borrows.late_return_status = 1 
   AND borrows.return_date IS NULL

由于 AND 优先级高于 OR，该语句被解析为：

WHERE [borrowers.borrower_name LIKE ?] 
   OR [borrowers.IC LIKE ? AND borrows.late_return_status = 1 AND borrows.return_date IS NULL]

因此只要姓名匹配，无论是否逾期、是否已归还，都会被返回。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

✅ 正确解法：使用 where() 闭包实现逻辑分组，强制将 OR 条件包裹在括号内：

$late_books = Borrow::join('books', 'borrows.book_id', '=', 'books.id')
    ->join('borrowers', 'borrows.borrower_id', '=', 'borrowers.id')
    ->where('borrows.late_return_status', 1)                 // 必选：逾期状态
    ->whereNull('borrows.return_date')                       // 必选：未归还（推荐用 whereNull 而非 = null）
    ->where(function ($query) use ($search) {
        $query->where('borrowers.borrower_name', 'like', "%{$search}%")
              ->orWhere('borrowers.IC', 'like', "%{$search}%");
    })
    ->get([
        'borrowers.borrower_name',
        'borrowers.IC',
        'borrowers.phone_no',
        'books.ISBN',
        'books.book_title',
        'books.year',
        'books.author',
        'books.publisher_name',
        'borrows.issue_date',
        'borrows.due_date'
    ]);

? 关键改进说明：

• 逻辑隔离：闭包内所有条件被包裹在 (...) 中，使最终 SQL 变为 WHERE late_return_status = 1 AND return_date IS NULL AND (name LIKE ? OR IC LIKE ?)；
• 语义清晰：whereNull() 替代 where('...', '=', null)，既符合 Laravel 最佳实践，也避免因 NULL = NULL 永假导致的意外结果；
• 安全建议：生产环境应使用 request()->input('search') 并配合 trim() 和空值校验，防止空搜索触发全表扫描；
• 性能提示：对 borrower_name 和 IC 字段建立复合索引（如 INDEX(borrower_name, IC)）可提升模糊查询效率。

总结：永远不要将 orWhere 直接置于多个 where 后而不加分组——它不是“追加一个 OR 条件”，而是重置当前逻辑层级。善用闭包分组，是写出健壮、可维护 Laravel 查询的基础能力。