nest 8.x 中 aggregationdescriptor 编译失败需确保：聚合链从 .aggregations() 开始、子聚合命名唯一、字段用表达式访问、嵌套聚合需重复调用 .aggregations()、nested 字段需显式包裹；带 filter 的分桶聚合须用 filter 容器嵌套 terms 和指标；管道聚合依赖精确的 bucketpath；取值须用 trygetvalue 和空值操作符防 nre。
NEST 8.x 中 AggregationDescriptor 编译失败怎么办
升级到 NEST 8.x 后，AggregationDescriptor<t></t> 的泛型约束变严格，常见写法如 .Aggregations(a => a.Terms("by_category", t => t.Field(f => f.Category))) 会报错：找不到匹配的重载。这不是语法错了，而是类型推导失败或嵌套聚合入口不合法。
必须确保：
- 所有聚合链式调用都从
.Aggregations()开始，且内部每个子聚合命名唯一（不能重复用"by_category"） - 字段访问必须通过表达式
f => f.Category，不能用字符串硬编码（如"category.keyword"），否则类型系统无法推导映射 - 若嵌套多层聚合（比如按日期桶内再求平均值），第二层必须用
.Aggregations()再开一次闭包，不能直接接在第一层后面 - ES 8.x 默认禁用
include_in_root，如果字段是Nested类型，得显式用.Nested(n => n.Path("tags"))包裹外层
怎么写带 filter 的分桶 + 指标聚合（比如“近7天销量最高的商品类目”）
这类需求本质是先过滤时间范围，再按类目分桶，最后对每个桶内文档计算 sum 或 avg。直接写 Terms + Sum 不行——filter 必须套在 Filter 聚合容器里，否则会被当成全局条件，桶内数据不隔离。
正确结构是：Filter → Terms → Aggregations → Sum：
var searchResponse = client.Search<product>(s => s
.Size(0)
.Aggregations(a => a
.Filter("recent_sales", f => f
.Filter(ff => ff
.DateRange(d => d
.Field(fld => fld.CreatedAt)
.GreaterThan("now-7d/d")
.LessThan("now/d")))
.Aggregations(aa => aa
.Terms("by_category", t => t.Field(fld => fld.Category))
.Aggregations(ta => ta
.Sum("total_revenue", sm => sm.Field(fld => fld.Price))))))</product>
注意点：
-
.Size(0)必须显式设置，否则 ES 返回全部命中文档，聚合结果可能被截断 -
DateRange的GreaterThan/LessThan值必须是 ES 可解析的时间表达式（如"now-7d/d"），不是 C#DateTime对象 - 如果
Category是keyword类型但没显式声明子字段，f => f.Category会自动转成category.keyword；但如果 mapping 里是text且没开fielddata=true，会静默返回空桶
管道聚合（Pipeline Aggregation）为什么返回 null
像 MaxBucket、Derivative 这类管道聚合，依赖上游聚合的命名和结构。常见错误是：上游聚合名拼错、路径写错、或者没把结果放在 .Aggregations 里而是直接挂在根上。
例如想取“各月份销售额的最大值”，必须：
- 先定义一个
DateHistogram聚合，命名为"monthly_sales" - 在它的
.Aggregations()里加Sum，命名为"revenue_sum" - 再在最外层
.Aggregations()里写MaxBucket，指定BucketPath = "monthly_sales>revenue_sum"
少一层命名或路径中用了点号以外的符号（比如空格或下划线），BucketPath 就解析失败，整个聚合字段为 null。Kibana 的 GET /index/_search?typed_keys 可查实际返回的聚合键名，别凭感觉猜。
聚合结果怎么安全取值，避免 NullReferenceException
NEST 8.x 不再自动填充空聚合结果，response.Aggs.Terms("by_category") 在没数据时直接是 null，不是空集合。硬解构会崩。
推荐写法：
- 用
response.Aggs.TryGetValue("by_category", out var terms)判断是否存在 - 取子聚合时，用
terms.Aggregations?.Sum("total_revenue")?.Value，每级都加? - 如果聚合名含特殊字符（如
"price-range"），必须用response.Aggs["price-range"]字符串索引，不能用点语法 - 聚合返回的
Bucket列表是IEnumerable<itermsbucket></itermsbucket>，遍历时别直接.ToList()，它底层是延迟执行的流式结构，多次枚举可能出错
最易忽略的是：ES 返回的聚合键名默认全小写，哪怕你在代码里写 "ByCategory"，实际响应里也是 "bycategory"——命名必须和 .Aggregations() 里传的字符串完全一致，大小写敏感。
