不能直接用 Laravel 的 withAvg() 查 Elasticsearch 平均值，必须通过 HTTP 请求发送 DSL 聚合语句到 _search 接口，设置 "size": 0，使用 avg 聚合指定 numeric 字段，支持多字段合并计算，注意类型、精度及空值处理。
不能直接用 Laravel 的 withAvg() 去查 Elasticsearch 的平均值——这是两种完全不同的数据层：Laravel Eloquent 面向 MySQL/PostgreSQL，Elasticsearch 聚合必须走 HTTP 请求 + DSL，两者不互通。
ES avg 聚合必须用原生 DSL 发起请求
想对 ES 索引中某个字段（比如 price、rating）批量算平均值，唯一可靠方式是构造 avg 聚合 DSL 并 POST 到 _search 接口。Laravel 本身不提供 ES 聚合封装，得靠 HTTP 客户端（如 Guzzle）或官方 PHP 客户端（elasticsearch/elasticsearch）发请求。
- 必须设置
"size": 0，否则会混入 hits 数据，干扰聚合结果 -
avg只接受numeric类型字段；若字段是text或未启用doc_values，返回空或报错 - 嵌套字段要用点号路径，例如
"field": "comments.rating"，但需确认 mapping 中该路径确实是double或long - 如果字段含大量
null或缺失值，avg会自动跳过——它只统计实际存在的数值
批量计算多个字段均值：用 multi-agg 合并请求
一次请求里同时查 price、rating、delivery_time 的平均值，比发三次请求更高效。DSL 中可并列定义多个 avg 聚合，每个起独立名字：
{
"size": 0,
"aggs": {
"avg_price": { "avg": { "field": "price" } },
"avg_rating": { "avg": { "field": "rating" } },
"avg_delivery": { "avg": { "field": "delivery_time" } }
}
}
- 返回结构中，
aggregations.avg_price.value是数字，可能为null（全字段缺失时） - 不要在同一个聚合名下重复定义，ES 会覆盖而非合并
- 若字段类型不一致（比如
price是scaled_float，rating是integer），不影响各自计算，但要注意精度差异
精度问题：avg 返回值不是精确小数
ES 的 avg 默认用 double 计算，大数据量下会出现浮点误差（例如期望 4562.34，返回 4562.340000000001）。这不是 bug，而是 IEEE 754 行为。
- 关键业务场景（如财务价格）应优先改用
scaled_float类型建索引，缩放因子设为100（即存分为单位的整数） - 无法改 mapping 时，可在 PHP 层用
round($value, 2)格式化，但注意这是展示层修复，非数据层修正 -
scripted_metric能自定义精度逻辑，但性能差、难调试，仅当 scaled_float 不可用时兜底
Laravel 中调用 ES 聚合的最小可行代码
用官方客户端最稳。假设已安装 elasticsearch/elasticsearch 并配置好连接：
$client = ClientBuilder::create()->setHosts(['http://localhost:9200'])->build();
$response = $client->search([
'index' => 'products',
'body' => [
'size' => 0,
'aggs' => [
'avg_price' => ['avg' => ['field' => 'price']],
'avg_rating' => ['avg' => ['field' => 'rating']]
]
]
]);
$avgPrice = $response['aggregations']['avg_price']['value'] ?? 0;
$avgRating = $response['aggregations']['avg_rating']['value'] ?? 0;
- 别漏掉
?? 0，因为value可能为null（无匹配文档或全字段为空） - 生产环境务必加 try/catch，ES 连接失败或 DSL 错误会抛
Exception - 避免在循环里反复调用聚合——要批量分析多个索引，先用 PHP 组装请求体，再并发调用
真正容易被忽略的是：ES 聚合结果不带类型信息，value 总是 float，哪怕原始字段是 integer；而 Laravel 模型里习惯用 int 或 float 强约束，这里需要显式转换或文档约定。
