Laravel ES聚合条件过滤查询缩小统计范围-php教程-PHP中文网

聚合前必须先用filter缩小文档集，因es聚合默认在全部匹配文档上运行，未过滤会导致统计失真；filter中条件不打分、可缓存，性能优于must；全文检索用must，过滤逻辑严格放在filter；terms聚合字段须为keyword类型，text字段需通过fields多字段映射支持聚合与检索；嵌套聚合需显式声明nested路径；laravel中需白名单校验用户输入参数并限制数值范围。

laravel es聚合条件过滤查询缩小统计范围

聚合前必须先用 filter 缩小文档集

ES 的聚合（aggs）默认在 query 返回的所有匹配文档上运行，但如果你只关心“已上架且价格 ≤ 5000 的商品”的类目分布，却没提前过滤，聚合结果就会包含下架或高价商品，统计失真。关键点在于：聚合本身不自动过滤，它只“数”你给它的数据。

正确做法是把确定性条件（如状态、范围、精确值）全塞进 bool.filter，再在其外层定义 aggs：

{
  "query": {
    "bool": {
      "filter": [
        {"term": {"sale": true}},
        {"range": {"price": {"lte": 5000}}}
      ]
    }
  },
  "aggs": {
    "by_category": {
      "terms": {"field": "category_id"}
    }
  }
}

filter 中的条件不参与相关性打分，可被缓存，性能远高于写在 must 里
别把 match 或 multi_match 放 filter——它们是查询语句，不是过滤器
如果要用全文检索+聚合，必须把检索逻辑放 must，过滤逻辑严格留在 filter，两者共存于同一 bool

terms 聚合字段必须是 keyword 类型

对 category_id 或 brand_name 做 terms 聚合时，如果字段在 mapping 中是 text 类型（默认会分词），ES 会按分词后碎片聚合，比如 “iPhone 15 Pro” 变成 [“iphone”, “15”, “pro”]，结果出现大量无意义单字桶。必须确认该字段类型为 keyword：

PUT /products/_mapping
{
  "properties": {
    "category_id": {"type": "keyword"},
    "brand_name": {"type": "keyword"}
  }
}

已有索引无法直接改字段类型，需 reindex；新索引建模阶段就要定死
若字段同时要支持全文检索和聚合，用 fields 多字段映射："type": "text", "fields": {"keyword": {"type": "keyword"}}，聚合时查 brand_name.keyword
别依赖 fielddata: true 强开 text 字段聚合——内存爆炸风险极高，9.x 已默认禁用

嵌套聚合需配合 inner_hits 或 reverse_nested

当商品有 skus 嵌套对象（含库存、颜色等），你想统计“每个颜色下的平均库存”，就不能直接对 skus.color 做 terms 聚合——嵌套字段必须显式声明路径并启用 nested 查询上下文。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

正确结构：

{
  "query": {
    "nested": {
      "path": "skus",
      "query": {
        "bool": {
          "filter": [
            {"term": {"skus.in_stock": true}}
          ]
        }
      }
    }
  },
  "aggs": {
    "by_color": {
      "nested": {"path": "skus"},
      "aggs": {
        "colors": {"terms": {"field": "skus.color"}},
        "avg_stock": {"avg": {"field": "skus.stock"}}
      }
    }
  }
}