Laravel多字段搜索实现方法详解

本文详解 Laravel 中跨模型关联字段（如主表 ID、名称及关联表 SKU）的精准搜索实现方法，解决因 `orWhere` 逻辑优先级导致的查询失效问题，并提供可复用的结构化搜索方案。

在 Laravel 中实现一个能同时匹配 product_id、product_name 和关联模型中的 itemSkuNumber 的搜索功能，关键在于正确处理查询作用域与逻辑分组。原始代码中直接在 with() 关系预加载里使用 orWhere()，不仅无法影响主查询结果（with() 仅控制关联数据加载条件），还会因 orWhere 的全局作用破坏原有 where 条件的逻辑关系，导致 SQL 生成错误（例如：WHERE name LIKE ? OR id = ? OR ... 脱离上下文），最终使 SKU 匹配完全失效。

正确的做法是：
✅ 使用 whereHas() 精确约束关联模型满足条件；
✅ 在 whereHas() 内部嵌套 where() + orWhere() 并用闭包包裹，确保逻辑分组（即 (itemSkuNumber = ? OR ...)）；
✅ 主查询统一处理 id 和 name 字段，并与关联条件通过 OR 合并，形成完整的“任一字段匹配即返回”的语义。

以下是推荐的完整实现：

$searchTerm = $request->input('search');

$products = Product::with('getProductItem')
    ->where(function ($query) use ($searchTerm) {
        // 主模型字段匹配：ID（精确）、name（模糊）
        $query->where('id', $searchTerm)
              ->orWhere('name', 'like', "%{$searchTerm}%");
    })
    ->orWhereHas('getProductItem', function ($query) use ($searchTerm) {
        // 关联模型字段匹配：仅 itemSkuNumber（精确匹配，可根据需求改为 like）
        $query->where('itemSkuNumber', $searchTerm);
    })
    ->get();

⚠️ 注意事项：

• 若需支持 SKU 的模糊搜索（如输入部分编号），将 where('itemSkuNumber', $searchTerm) 改为 where('itemSkuNumber', 'like', "%{$searchTerm}%")；
• 避免在 with() 中使用 orWhere —— 它只影响预加载的关联数据筛选，不参与主查询过滤；
• 使用 where(...)->orWhere(...) 时务必用外层 where(function () {}) 包裹，防止运算符优先级引发意外结果；
• 如搜索字段较多或需动态组合条件，建议封装为查询构建器方法或使用 Laravel Scout 进行全文检索升级。

该方案结构清晰、可维护性强，兼顾性能与语义准确性，是 Laravel 多字段跨表搜索的标准实践。