如何在 Laravel 查询构建器中组合 AND 与多个 OR 条件

本文详解如何使用 laravel 原生查询构建器（非 eloquent）实现「主条件为 and，子条件为多组 or 并包裹在括号内」的 sql 构建，重点利用闭包分组和 `orwhere` 动态拼接。

在 Laravel 查询构建器中，若需生成形如 WHERE column_A > 100 AND (column_B = ? OR column_B = ? OR column_B = ?) 的 SQL，关键在于逻辑分组——必须将多个 OR 条件置于同一作用域内，否则会因优先级问题导致意外结果（例如 WHERE A AND B OR C 等价于 (A AND B) OR C，而非预期的 A AND (B OR C)）。

Laravel 提供了通过闭包（Closure）实现条件分组的机制。只需将 OR 相关条件传入 where() 方法的回调函数中，框架便会自动为其添加括号包裹。

以下为完整实现示例：

use Illuminate\Support\Facades\DB;

$conditions = [
    ['column_B', '=', 'value_1'],
    ['column_B', '=', 'value_2'],
    ['column_B', '=', 'value_3'],
    ['column_B', '=', 'value_n'],
];

$query = DB::table('list')
    ->where('column_A', '>', 100)
    ->where(function ($query) use ($conditions) {
        foreach ($conditions as $condition) {
            $query->orWhere(...$condition);
        }
    });

// 执行查询
$results = $query->get();

✅ 该写法生成的标准 SQL 与需求完全一致：

SELECT * FROM `list` 
WHERE `column_A` > 100 
  AND (`column_B` = 'value_1' OR `column_B` = 'value_2' OR `column_B` = 'value_3' OR `column_B` = 'value_n')

⚠️ 注意事项：

• 不可省略闭包：直接链式调用多个 orWhere()（如 ->orWhere(...)->orWhere(...)）会脱离主 WHERE 分组，导致逻辑错误；
• 参数解构需谨慎：...$condition 要求 $condition 是三元数组 [字段, 操作符, 值]，顺序必须严格匹配 where() 方法签名；
• 若条件数组为空，上述闭包内循环不会执行，最终生成的 SQL 将缺少 OR 子句（即退化为 WHERE column_A > 100），如需健壮性，建议提前校验或使用 when() 配合空值跳过；
• 如需支持 IN 语义（即 column_B IN (?, ?, ?)），更简洁高效的方式是：->whereIn('column_B', ['value_1', 'value_2', 'value_3']) —— 但本方案聚焦于动态构造任意 OR 表达式，适用于混合操作符（如 ['column_B', 'LIKE', '%val%'] 或 ['column_B', '!=', 'excluded']）等复杂场景。

综上，利用闭包分组 + 可变参数解构，是 Laravel 查询构建器中灵活、安全、可维护地组合嵌套布尔逻辑的标准实践。