适用版本： 7.x-8.x
1. 错误异常的基本描述 #
Registry miss-match - expected SignificantTermsAggregatorSupplier; found [...] 表示 Elasticsearch 已经进入聚合构建阶段，并尝试从 ValuesSourceRegistry 取得 SignificantTermsAggregationBuilder 所需的聚合器实现，但实际返回对象不是 SignificantTermsAggregatorSupplier，于是直接抛出 AggregationExecutionException。
常见现象 #
- 请求通常在执行
significant_terms聚合时失败，而不是在网络连接或权限校验阶段失败。 - 服务端日志里会同时出现
AggregationExecutionException、registry miss-match、SignificantTermsAggregatorSupplier等关键字。 - 问题多见于聚合 DSL、字段类型、插件实现或节点版本不一致导致的注册表映射异常。
2. 为什么会发生这个错误 #
从附带源码可以看到，Elasticsearch 会调用 queryShardContext.getValuesSourceRegistry().getAggregator(...) 获取 SignificantTermsAggregationBuilder 对应的聚合器供应器，然后立即用 instanceof SignificantTermsAggregatorSupplier 做类型校验。只要注册表返回的实现类型不符合预期，就会抛出当前异常，而不会继续构建聚合。
这说明问题的根因不在“请求有没有到达集群”，而在“significant_terms 这条执行路径拿到的 Supplier 类型不匹配”。常见触发场景包括：
significant_terms聚合被错误地套用到不合适的字段类型或脚本结果上，导致值源解析与注册实现错位。- 集群存在版本混跑、插件不一致或自定义扩展覆盖注册逻辑，导致不同节点注册了不同的聚合器实现。
- 滚动升级、插件升级或回滚后，协调节点与数据节点对同一个聚合名称解析到了不同的 Supplier。
- 请求经过网关、SDK 或模板渲染后，最终发出的聚合名称、字段名或参数和预期不一致。
3. 如何排查和解决这个异常和解决这个异常 #
- 抓取失败请求的完整 DSL，确认实际使用的是
significant_terms，并核对字段名、background_filter、include/exclude等参数。 - 对照目标字段的
mapping，确认字段类型确实适合做significant_terms分析，重点检查keyword子字段、数值字段和运行时字段。 - 核对所有节点的 Elasticsearch 版本、已安装插件和自定义扩展是否一致，避免注册表实现不一致。
- 如果问题出现在升级、回滚或插件变更之后，优先检查是否有节点未完成重启或仍加载旧版本代码。
- 在测试环境用最小 DSL 复现，只保留一个
significant_terms聚合和一个字段，逐步回填参数，定位究竟是聚合类型、字段类型还是节点实现造成的错配。
4. 如何解决这个错误 #
常用修复思路 #
- 把聚合类型改回与字段类型匹配的实现，不要把其他聚合模板直接复用到
significant_terms。 - 清理或统一自定义插件、扩展包和节点版本，保证所有节点对
SignificantTermsAggregationBuilder.NAME注册同一类 Supplier。 - 对滚动升级中的集群，确认所有节点都已完成升级并重新加入集群后再执行相关聚合请求。
- 如果请求由代码动态生成，补充聚合白名单和字段类型校验，避免错误 DSL 进入生产环境。
后续建议 #
- 对复杂聚合请求记录原始 DSL、失败节点和相关字段 mapping，后续定位会快很多。
- 把插件版本、节点版本和聚合错误趋势纳入监控，避免类似问题在变更后批量出现。
- 如果前面有流量网关或代理，保留请求采样，确认真正发送到 Elasticsearch 的聚合结构没有被二次改写。
5. 小结 #
这类 registry miss-match 异常的关键点是：Elasticsearch 已经找到了一个聚合器实现，但这个实现不是 SignificantTermsAggregationBuilder 这条执行路径期望的 SignificantTermsAggregatorSupplier。因此，修复重点应放在聚合类型、字段类型、插件注册和节点版本一致性上，而不是简单重试请求。
相关错误 #
附：日志上下文 #
CardinalityUpperBound cardinality;
Mapmetadata) throws IOException {
AggregatorSupplier aggregatorSupplier = queryShardContext.getValuesSourceRegistry().getAggregator(config;
SignificantTermsAggregationBuilder.NAME);
if (aggregatorSupplier instanceof SignificantTermsAggregatorSupplier == false) {
throw new AggregationExecutionException("Registry miss-match - expected SignificantTermsAggregatorSupplier; found [" +
aggregatorSupplier.getClass().toString() + "]");
}
SignificantTermsAggregatorSupplier sigTermsAggregatorSupplier = (SignificantTermsAggregatorSupplier) aggregatorSupplier; BucketCountThresholds bucketCountThresholds = new BucketCountThresholds(this.bucketCountThresholds);
