本文介绍 Laravel 查询构造器中如何正确构建带逻辑分组的 WHERE 条件（如 WHERE id = 1111 AND (column1 IS NULL OR column2 = 'sample')），避免 orWhereNull() 导致的意外全局 OR 行为。
本文介绍 laravel 查询构造器中如何正确构建带逻辑分组的 where 条件（如 `where id = 1111 and (column1 is null or column2 = 'sample')`），避免 `orwherenull()` 导致的意外全局 or 行为。
在 Laravel 中，直接链式调用 ->where(...)->orWhereNull(...) 会导致所有条件被扁平化为同一级逻辑（即隐式 OR 关系），无法体现 SQL 中括号所表达的优先级分组。例如：
// ❌ 错误写法：生成 WHERE id = 1111 OR column1 IS NULL OR column2 = 'sample'
User::where('id', 1111)
->orWhereNull('column1')
->orWhere('column2', 'sample')
->get();
这会破坏原始 SQL 的语义——你真正需要的是 AND (column1 IS NULL OR column2 = 'sample')，即括号内为 OR，整体与前面条件为 AND。
✅ 正确做法是使用闭包逻辑分组（Query Scopes with Closure），通过 where() 接收一个闭包参数，在闭包内部定义子查询条件。Laravel 会自动将其编译为带括号的子条件：
$users = User::where('id', 1111)
->where(function ($query) {
$query->whereNull('column1')
->orWhere('column2', 'sample');
})
->get();
生成的 SQL 等效于：
SELECT * FROM `users` WHERE `id` = 1111 AND (`column1` IS NULL OR `column2` = 'sample')
? 小贴士：
- 所有在闭包中使用的 where* 方法（如 whereNull, whereNotNull, whereIn, whereBetween）均受该分组约束；
- 可嵌套多层分组以构建复杂查询（如 AND (A OR B) AND (C OR D)）；
- 若需动态添加分组条件，可在闭包中加入 if 判断，保持逻辑清晰且无 SQL 注入风险。
总结：Laravel 的闭包分组机制是精准还原 SQL 括号逻辑的关键工具。牢记“外部 where 控制层级关系，闭包 where 定义括号范围”，即可写出语义准确、可维护性强的 Eloquent 查询。
