闭包分组是唯一可靠解法：用 where() 包裹 orwhere 条件，生成带括号的 sql，确保 and 优先级正确，避免 or 逃出上下文导致越权或错漏。

直接链式调用 orWhere 多个条件，不加闭包分组，是 Laravel 查询中最常见的逻辑翻车点——它会让 OR 条件“逃出”原本的 AND 上下文，导致数据越权、结果错漏、权限失控。

典型错误写法：看似合理，实则危险

比如想查「状态为 active 且（用户名或邮箱匹配关键词）」，却写了：

• ->where('status', 'active')
• ->orWhere('name', 'like', "%{$search}%")
• ->orWhere('email', 'like', "%{$search}%")

生成的 SQL 实际是：
WHERE status = 'active' OR name LIKE ? OR email LIKE ?
这意味着只要 name 或 email 匹配，哪怕 status 是 draft、deleted、banned，全都会被拉出来——完全违背业务意图。

根本原因：SQL 运算符优先级没被尊重

SQL 中 AND 优先级高于 OR，但 Laravel 查询构造器不会自动加括号。链式 where + orWhere 是扁平拼接，不是树形结构。上面三行代码等价于：

(status = 'active') OR (name LIKE ...) OR (email LIKE ...)

而不是你真正想要的：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

status = 'active' AND (name LIKE ... OR email LIKE ...)

正确解法：闭包分组是唯一可靠手段

把所有需要“或”关系的条件，统一放进一个 where() 闭包里：

• ->where('status', 'active')
• ->where(function ($q) use ($search) {
•   $q->where('name', 'like', "%{$search}%")
•     ->orWhere('email', 'like', "%{$search}%");
• })

此时生成的 SQL 自动带括号：
WHERE status = 'active' AND (name LIKE ? OR email LIKE ?)
逻辑清晰，安全可控。

进阶场景：动态条件 + 多层 orWhere 分组

搜索表单常含可选字段（如手机号、身份证、订单号），不能硬写死。推荐结合 when() 和嵌套闭包：

• ->when($request->filled('keyword'), function ($q) use ($request) {
•   $q->where(function ($sub) use ($request) {
•     $sub->where('name', 'like', "%{$request->keyword}%")
•       ->orWhere('phone', $request->keyword)
•       ->orWhere('id_card', $request->keyword);
•   });
• })

这样既避免空搜索触发 LIKE '%%' 全表扫描，又确保所有 or 条件严格受主过滤约束。