Laravel中实现Elasticsearch嵌套聚合+排序+二次统计必须手写原生DSL：需显式声明nested路径、正确嵌套min_bucket管道聚合、避免PHP数组键名覆盖，并通过mapping验证nested类型。
直接说结论：Laravel 中调用 Elasticsearch 做嵌套聚合 + 排序 + 二次统计（比如“每组内取 avg 最低的桶”），不能靠 Query Builder 或 Eloquent 封装，必须手写原生 DSL，并注意 nested 字段声明、path 指定、min_bucket 管道聚合的嵌套层级和命名链路 —— 否则返回空或报错 Unknown aggregation type [min_bucket]。
嵌套字段聚合前必须显式声明 nested 路径
Elasticsearch 不会自动识别对象数组为嵌套结构。如果 mapping 中 comments 是 nested 类型，但聚合时没加 nested 上下文，所有子对象会被扁平化处理，导致分组错乱或指标失真。
- 错误写法：
"aggs": {"by_user": {"terms": {"field": "comments.user.keyword"}}}→ 返回全部用户混在一起的桶 - 正确写法：
"aggs": {"nested_comments": {"nested": {"path": "comments"}, "aggs": {"by_user": {"terms": {"field": "comments.user.keyword"}}}}} - 验证方式：用
GET /index/_mapping确认字段类型是否为"type": "nested"，不是就需 reindex
min_bucket 管道聚合必须接在多级桶聚合之后
想实现“找出各商品类型中平均评分最低的档次”，本质是先按 type 分桶 → 再按 lv 分桶 → 每个 lv 桶里算 avg_rating → 最后从所有 lv 桶中挑出 avg_rating 最小的那个桶。这个“最后一步”必须用管道聚合，且依赖上层桶的完整命名链。
- 关键点：管道聚合不能独立存在，必须挂载在某个桶聚合的
aggs下，且引用目标指标时要用完整路径，如"buckets_path": "lv_bucket>avg_rating.value" - 常见漏写：
lv_bucket名字不一致、avg_rating缺少.value后缀、没把min_bucket放在lv_bucket的aggs里 - 示例片段：
"lv_bucket": { "terms": {"field": "lv"}, "aggs": { "avg_rating": {"avg": {"field": "rating"}}, "min_lv_by_avg": { "min_bucket": {"buckets_path": "avg_rating.value"} } } }
Laravel 中拼接 DSL 时避免数组键名被覆盖
PHP 数组不支持重复键名，而 Elasticsearch DSL 多层 aggs 嵌套时，常需同名 key（如多处叫 aggs）。直接用 PHP 关联数组层层赋值，容易因键名冲突丢掉内层定义。
- 错误习惯：
$dsl['aggs']['outer'] = [...]; $dsl['aggs']['outer']['aggs']['inner'] = [...];→ 第二行可能被忽略或覆盖 - 安全做法：用引用变量逐层构造，或用
json_decode(file_get_contents(...), true)加载模板再修改关键字段 - 调试技巧：打印
json_encode($dsl, JSON_PRETTY_PRINT)对比预期 DSL 结构，重点检查aggs层级是否完整
最易被忽略的是 min_bucket 的输出位置 —— 它不会出现在顶层 aggregations 下，而是紧贴在它所依附的桶聚合内部，且只返回一个桶（含 key、doc_count、指标值）。如果在 Laravel 里用 collect($response['aggregations'])->pluck(...) 直接取值，很容易因路径写错拿不到结果。
