---
title: "未注册的聚合 - 如何解决此 Elasticsearch 异常"
date: 2026-02-24
lastmod: 2026-02-24
description: "Elasticsearch尝试使用未注册或不存在的聚合导致的错误及解决方案"
tags: ["Elasticsearch", "聚合", "聚合注册", "查询错误"]
summary: " 版本： 7.8-7.9
 简而言之，当您尝试使用Elasticsearch中未注册或不存在的聚合时，就会出现此错误。这可能是由于聚合名称拼写错误，或使用了当前Elasticsearch版本不支持的聚合造成的。要解决此问题，您可以检查聚合名称的拼写，确保聚合在您的Elasticsearch版本中受支持，或者如果是自定义聚合，则注册该聚合。
日志上下文 #  日志"Unregistered Aggregation [" + aggregationName + “]“的类名是 ValuesSourceRegistry.java。我们从Elasticsearch源代码中提取了以下内容，供那些寻求深入上下文的人使用：
valuesSourceConfig.getDescription() + " is not supported for aggregation [" + aggregationName + "]" ); } return supplier; } throw new AggregationExecutionException("Unregistered Aggregation [" + aggregationName + "]"); } public AggregationUsageService getUsageService() { return usageService; } "
---



> **版本：** 7.8-7.9

简而言之，当您尝试使用Elasticsearch中未注册或不存在的聚合时，就会出现此错误。这可能是由于聚合名称拼写错误，或使用了当前Elasticsearch版本不支持的聚合造成的。要解决此问题，您可以检查聚合名称的拼写，确保聚合在您的Elasticsearch版本中受支持，或者如果是自定义聚合，则注册该聚合。

## 日志上下文

日志"Unregistered Aggregation [" + aggregationName + "]"的类名是[ValuesSourceRegistry.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从Elasticsearch源代码中提取了以下内容，供那些寻求深入上下文的人使用：

```java
valuesSourceConfig.getDescription() + " is not supported for aggregation [" + aggregationName + "]"
);
}
return supplier;
}
throw  new AggregationExecutionException("Unregistered Aggregation [" + aggregationName + "]");
}  public AggregationUsageService getUsageService() {
    return usageService;
}
```