在 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 查询的基础能力。
