本文详解如何在 laravel eloquent/query builder 中结合 leftjoin 实现多表“任一条件成立”的 or 查询，避免因 where/orwhere 优先级导致的逻辑错误，并推荐使用 wherenotnull + 闭包分组等健壮写法。
本文详解如何在 laravel eloquent/query builder 中结合 leftjoin 实现多表“任一条件成立”的 or 查询，避免因 where/orwhere 优先级导致的逻辑错误，并推荐使用 wherenotnull + 闭包分组等健壮写法。
在 Laravel 中执行多表 leftJoin 并配合 OR 条件筛选（例如“产品只要在 sales、novelties、liquidations 或 exposures 中任意一张表存在有效结束时间即可”）时，直接链式调用 ->where(...)->orWhere(...)->orWhere(...) 极易引发意料之外的结果——首条 where 条件会成为整个 OR 组合的“锚点”，导致后续 orWhere 实际与它进行逻辑或运算，而非彼此之间构成并列 OR 关系。这正是原问题中仅返回 novelty_end_at 非空产品的原因：SQL 解析为 WHERE (novelty_end_at IS NOT NULL) OR (sale_end_at IS NOT NULL) OR ... 是正确的，但若首个 where 写成 ->where('noveltys.novelty_end_at', '!=', null)，则因 SQL 中 != NULL 永远为 false（应使用 IS NOT NULL），且 Laravel 的 where(..., '!=', null) 不会自动转义为标准 SQL 的 IS NOT NULL，从而让整个 WHERE 子句失效或行为异常。
✅ 正确做法是：统一使用 whereNotNull() 方法（它会生成标准、可靠的 IS NOT NULL 表达式），并强烈建议将所有 OR 条件包裹在闭包中，通过 where(function ($q) { ... }) 显式分组，确保逻辑清晰、可维护且不受优先级干扰。
以下是推荐的三种实现方式（按推荐度排序）：
✅ 方式一：Query Builder + 闭包分组（最推荐）
use Illuminate\Support\Facades\DB;
$products = DB::table('products')
->leftJoin('sales', 'sales.product_id', '=', 'products.id')
->leftJoin('liquidations', 'liquidations.product_id', '=', 'products.id')
->leftJoin('noveltys', 'noveltys.product_id', '=', 'products.id')
->leftJoin('exposures', 'exposures.product_id', '=', 'products.id')
->where(function ($query) {
$query->whereNotNull('sales.sale_end_at')
->orWhereNotNull('noveltys.novelty_end_at')
->orWhereNotNull('liquidations.liquidation_end_at')
->orWhereNotNull('exposures.exposure_end_at');
})
->select('products.*')
->get();✅ 优势：语义明确、逻辑隔离、兼容性好；select('products.*') 避免字段名冲突（如多表均有 id 字段）；闭包确保 OR 条件整体作为单个子句参与主 WHERE。
✅ 方式二：Eloquent Model + Query Builder 混合（保持模型能力）
$products = Product::join('sales', 'sales.product_id', '=', 'products.id')
->leftJoin('liquidations', 'liquidations.product_id', '=', 'products.id')
->leftJoin('noveltys', 'noveltys.product_id', '=', 'products.id')
->leftJoin('exposures', 'exposures.product_id', '=', 'products.id')
->where(function ($q) {
$q->whereNotNull('sales.sale_end_at')
->orWhereNotNull('noveltys.novelty_end_at')
->orWhereNotNull('liquidations.liquidation_end_at')
->orWhereNotNull('exposures.exposure_end_at');
})
->select('products.*')
->get();⚠️ 注意：此处用 join 替代 leftJoin 于 sales 表，是因为 whereNotNull('sales.sale_end_at') 要求该字段存在，故 sales 表实际需为内连接；其余表仍用 leftJoin 以保留无匹配记录的产品。
⚠️ 方式三：纯 Eloquent（不推荐用于复杂 JOIN+OR）
Eloquent 的 whereHas() 适用于“存在关联记录”的判断，但本例需检查关联表中特定字段非空，且涉及四张不同表，无法优雅地用 whereHas 组合。强行使用会导致 N+1 或复杂子查询，性能与可读性均不佳，故不推荐。
? 关键注意事项
- 永远避免 where(..., '!=', null)：PHP null 在 SQL 中不能用 != 判断，必须用 IS NOT NULL —— Laravel 的 whereNotNull() 是唯一安全选择。
- 字段别名冲突：若 select() 包含多张表的 *（如 'sales.*', 'products.*'），当它们有同名字段（如 id, created_at）时，结果集会覆盖，引发数据错乱。务必显式指定所需字段或使用 select('products.*')。
- 索引优化：确保 sales.sale_end_at、noveltys.novelty_end_at 等被查询的字段已建立数据库索引，否则 LEFT JOIN 后全表扫描将严重拖慢性能。
- 空值处理一致性：确认业务中“有效结束时间”确实存储为 NULL（而非 '0000-00-00' 或空字符串），否则 whereNotNull() 将遗漏数据。
掌握 whereNotNull() 与闭包分组的组合，是写出健壮、可维护 Laravel 多表 OR 查询的基石。它不仅解决当前问题，更为你处理类似“多状态标记”“多渠道归属”等场景提供了标准化范式。
