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



> **版本：** 7.1-8.4

简而言之，当Elasticsearch尝试执行系统中未注册的聚合时，就会出现此错误。这可能是由于聚合名称拼写错误，或使用了当前Elasticsearch版本不支持的聚合造成的。要解决此问题，您应该验证聚合名称并确保其拼写正确且在您的Elasticsearch版本中受支持。如果您使用的是自定义聚合，请确保它已正确注册。

## 日志上下文

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

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