ES聚合排序必须在聚合内部用order参数指定，如terms聚合需设"order": {"_count": "desc"}；Laravel中应封装规整逻辑，用data_get安全取值并映射字段名，避免空值报错。
ES聚合结果里怎么按统计值排序
聚合（aggs）本身不支持直接用 sort 字段控制顺序，必须在聚合定义内部用 order 参数指定。常见错误是把排序写到顶层 sort 里，结果完全没生效。
比如想按「每个分类的商品数量」降序排列，得这么写：
{"aggs": {"category_count": {"terms": {"field": "category.keyword", "size": 10, "order": {"_count": "desc"}}}}}
order 必须嵌在对应聚合桶（如 terms）内部，且键名要对：数值类用 _count、_key，指标类用 metric_name（如 avg_price.value）。
- 默认最多返回 10 个桶，
size要显式设大一点才能看到全部结果 -
terms聚合的field必须是keyword类型，text类型字段会报错或返回空 - 如果要按子聚合结果排序，比如「每个分类的平均价格」，得用嵌套路径：
{"order": {"avg_price": "desc"}}，前提是子聚合别名设为avg_price
Laravel里怎么把ES聚合结果转成标准数组结构
ES 返回的聚合数据嵌套很深，$result['aggregations']['category_count']['buckets'] 这种写法容易出错，也不利于前端消费。建议封装一层规整逻辑。
示例：提取 terms 聚合的 key-value 对并补全缺失字段：
$buckets = $result['aggregations']['category_count']['buckets'] ?? [];
$categories = array_map(function ($bucket) {
return [
'name' => $bucket['key'] ?? '',
'count' => $bucket['doc_count'] ?? 0,
'avg_price' => $bucket['avg_price']['value'] ?? 0.0,
];
}, $buckets);
- 永远检查
aggregations和buckets是否存在，ES 在无匹配时可能根本不返回该键 - 用
??提供默认值，避免 PHP Notice；不要依赖isset()嵌套判断 - 前端需要「全部」选项？手动在数组开头
array_unshift($categories, ['name' => '全部', 'count' => $total])
多级聚合嵌套时排序失效的坑
当用 terms 套 avg 再套 top_hits，排序只对当前层级生效。比如你给外层 terms 设了 order: {"avg_price": "desc"}，但内层 top_hits 默认还是按相关度排，不是按价格。
正确做法：每层都要单独配 sort，且字段路径要写对：
{"aggs": {"by_category": {"terms": {"field": "category.keyword", "order": {"avg_price": "desc"}},
"aggs": {"avg_price": {"avg": {"field": "price"}},
"top_3": {"top_hits": {"size": 3, "sort": [{"price": {"order": "desc"}}]}}
}
}}
-
top_hits的sort是数组，哪怕只排一个字段也要包一层[] - 字段名带点号（如
user.name）要确保 mapping 是keyword或启用了fielddata - 聚合层级越深，响应越慢，
size别设太大，尤其top_hits每个桶都查 N 条文档
PHP 数组键名和 ES 返回字段名不一致怎么办
ES 默认返回的字段名带下划线（如 _id、doc_count），Laravel 模型习惯用驼峰（docCount）。硬编码转换易出错，建议统一用 Laravel 的 Arr::dot() 或自定义映射表。
简单映射示例：
$fieldMap = [
'key' => 'name',
'doc_count' => 'count',
'avg_price.value' => 'avgPrice',
];
$normalized = Arr::mapWithKeys($buckets, function ($v, $k) use ($fieldMap) {
return collect($fieldMap)->mapWithKeys(function ($to, $from) use ($v) {
$val = data_get($v, $from);
return [$to => $val];
})->all();
});
-
data_get()能安全取嵌套字段，比$v['avg_price']['value']少一堆空判断 - 别用
str_replace('_', '', $key)简单处理，像_count→count会和业务字段冲突 - 如果聚合字段来自脚本（
scripted_metric），返回的 key 完全由你控制，提前约定好命名规则更省事
