Laravel 8 多表联合搜索：在关联模型中实现跨表模糊查询

本文详解如何在 laravel 8 中基于 eloquent 关系，在保持原有查询结构（如 `with()`、`withcount()`）的前提下，安全高效地扩展搜索范围至关联表（如 `stock`、`category` 等），避免 n+1 或查询断裂。

在 Laravel 中，当主模型（如 Term）与多个关联模型（如 stock、category、attributes）存在 belongsTo 或 hasOne 关系时，仅对主表字段（如 title）搜索远远不够。用户常需同时按 stock.code、category.name 或 attributes.value 等跨表字段进行模糊检索——而不能破坏已有的 eager loading 和聚合查询逻辑。

正确做法是使用 whereHas()（用于 belongsTo/hasOne 关系）或 whereDoesntHave()，配合闭包约束，在关联表中执行子查询。它不会影响主查询的 with() 加载，也不会导致 SQL JOIN 冗余（除非显式调用 join()），语义清晰且性能可控。

以下为优化后的完整示例（适配你的场景）：

$posts = Term::where('user_id', $user_id)
    ->where('status', 1)
    ->where('type', 'product')
    ->with(['preview', 'attributes', 'category', 'price', 'options', 'stock', 'affiliate'])
    ->withCount('reviews');

// 支持多字段跨表搜索：title（主表）、code（stock 表）、name（category 表）
if (!empty($request->term)) {
    $search = '%' . $request->term . '%';
    $posts = $posts->where(function ($query) use ($search) {
        // 主表匹配
        $query->where('title', 'LIKE', $search)
              // 关联 stock 表（假设 Term hasOne Stock）
              ->orWhereHas('stock', function ($q) use ($search) {
                  $q->where('code', 'LIKE', $search);
              })
              // 关联 category 表（假设 Term belongsTo Category）
              ->orWhereHas('category', function ($q) use ($search) {
                  $q->where('name', 'LIKE', $search);
              })
              // 可继续添加其他关联字段，如 attributes.value
              ->orWhereHas('attributes', function ($q) use ($search) {
                  $q->where('value', 'LIKE', $search);
              });
    });
}

$data = $posts->get(); // 执行最终查询

✅ 关键要点说明：

• 使用 where(...) 包裹 orWhereHas()，防止逻辑优先级错误（否则 orWhere 会脱离主条件）；
• whereHas() 自动处理关联关系的外键匹配（如 stock.term_id = terms.id），无需手动写 join；
• 所有 with() 预加载仍生效，避免 N+1；withCount() 同样不受影响；
• 若关联关系是 hasMany（如一个 Term 有多个 stock 记录），whereHas() 默认匹配「至少一条满足」，符合模糊搜索预期；如需「全部匹配」，需改用 whereDoesntHave() 取反逻辑；
• 安全性提示： 始终使用参数绑定（Eloquent 自动处理），避免拼接 SQL 字符串，杜绝 SQL 注入。

? 进阶建议：

• 对高频搜索字段（如 stock.code、category.name）添加数据库索引；
• 如搜索逻辑复杂或涉及多层嵌套（如 stock → warehouse → city），可考虑使用 whereHas(...)->whereHas(...) 链式调用；
• 若需全文检索能力，建议升级至 Laravel Scout + Algolia/Meilisearch，而非依赖 LIKE 模糊匹配。

通过 whereHas()，你既能优雅扩展搜索边界，又能完全保留原有数据加载结构——这才是 Laravel 关系型查询的正确打开方式。