本文介绍如何优化 Laravel 中基于两个价格字段（如 actual_price 和 saleable_price）的范围筛选逻辑，避免重复 when() 调用，利用闭包合并条件，并确保 SQL 分组正确，防止逻辑错误。
本文介绍如何优化 laravel 中基于两个价格字段（如 actual_price 和 saleable_price）的范围筛选逻辑，避免重复 `when()` 调用，利用闭包合并条件，并确保 sql 分组正确，防止逻辑错误。
在 Laravel 中对多个价格字段（例如 actual_price 和 saleable_price）执行“任一满足区间”的筛选时，初学者常误用多个 when() 链式调用，导致生成错误的 SQL 条件（如 WHERE status=1 AND (actual_price BETWEEN ... ) OR (saleable_price BETWEEN ...)），因缺少括号分组而破坏优先级，引发意外结果。
✅ 正确做法是：将两个 whereBetween 合并在同一个 when() 闭包中，并显式使用 where() + orWhere() 组合，同时借助 where(function ($q) { ... }) 确保逻辑分组。以下是优化后的标准写法：
public function index(Request $request)
{
$products = Product::query()
->where('status', '1')
->when($request->filled('range'), function ($query) {
$query->where(function ($q) {
$q->whereBetween('actual_price', [0, 1600])
->orWhereBetween('saleable_price', [0, 1600]);
});
})
->orderBy('saleable_price', 'asc')
->get();
return view('frontend.product.index', compact('products'));
}? 关键说明：
- 使用 $request->filled('range') 替代 $request->range 更健壮（可区分 null、空字符串、0 等 falsy 值）；
- 外层 where(function () { ... }) 是核心：它将 AND (actual_price BETWEEN ... OR saleable_price BETWEEN ...) 封装为原子条件，保障 SQL 语义准确；
- 若需动态传入价格范围（而非硬编码 [0, 1600]），可进一步提取为请求参数，例如：
->when($request->filled('min_price') && $request->filled('max_price'), function ($query) use ($request) {
$min = (float) $request->min_price;
$max = (float) $request->max_price;
$query->where(function ($q) use ($min, $max) {
$q->whereBetween('actual_price', [$min, $max])
->orWhereBetween('saleable_price', [$min, $max]);
});
})⚠️ 注意事项：
- 切勿省略内层 where(function () { ... }) —— 否则 orWhereBetween 会脱离 status = 1 的主 AND 上下文，造成全表误匹配；
- 若需「两个字段同时满足区间」（即 AND 关系），则直接链式调用 whereBetween() 即可，无需 orWhere；
- 建议为 actual_price 和 saleable_price 字段添加数据库索引以提升查询性能。
此写法简洁、语义清晰、符合 Laravel 最佳实践，且完全利用框架原生查询构建器能力，无需额外扩展包或自定义宏。
