在 laravel 查询中，直接链式调用 orwhere 会破坏原有 where 条件的逻辑优先级，导致必要过滤（如状态、空值判断）被绕过；正确做法是使用闭包进行逻辑分组，确保 orwhere 仅作用于其所属的子条件块。
在 laravel 查询中，直接链式调用 orwhere 会破坏原有 where 条件的逻辑优先级，导致必要过滤（如状态、空值判断）被绕过；正确做法是使用闭包进行逻辑分组，确保 orwhere 仅作用于其所属的子条件块。
当你在 Laravel Eloquent 或 Query Builder 中混合使用 where() 和 orWhere() 时，必须注意 SQL 的运算符优先级：OR 的优先级低于 AND，而 Laravel 默认按调用顺序生成 SQL，不会自动加括号。因此以下写法：
->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 优先级更高，该语句等同于：
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'
]);? 关键要点：
- 必填条件前置：将 late_return_status = 1 和 return_date IS NULL 放在闭包前，确保它们作为全局约束；
- 搜索条件封装：用 where(function () {}) 将 name 和 IC 的 OR 关系限定在独立子句中，生成 (name LIKE ? OR IC LIKE ?)；
- 使用 whereNull()：比 where('col', '=', null) 更语义清晰且兼容各数据库（后者在部分驱动中可能生成 = NULL，而 SQL 中应使用 IS NULL）；
- 避免 SQL 注入风险：示例中 $search 应已通过 request()->string('search') 或 trim() 等方式预处理，生产环境建议配合 when() 方法实现条件式查询。
? 进阶提示：若需支持空搜索（即不输入关键词时返回全部逾期未还记录），可进一步优化为：
->when($search, function ($query) use ($search) {
return $query->where(function ($q) use ($search) {
$q->where('borrowers.borrower_name', 'like', "%{$search}%")
->orWhere('borrowers.IC', 'like', "%{$search}%");
});
})这样既保持逻辑严谨，又提升代码健壮性与可维护性。
