---
title: "聚合名称基数必须为1但实际为基数 - 如何解决此Elasticsearch异常"
date: 2026-03-30
lastmod: 2026-03-30
description: "当Elasticsearch聚合操作的基数（唯一值数量）不为1时会出现此错误。通常由配置错误或数据不一致引起，解决方法是确保聚合字段的基数为1，或使用支持高基数的其他聚合类型。"
tags: ["Elasticsearch异常", "聚合操作", "基数错误", "GlobalAggregator"]
summary: " 版本： 7.9-8.9
 简而言之，当尝试执行Elasticsearch聚合操作时，如果基数（唯一值的数量）不为1，就会出现此错误。这可能是由于配置错误或数据不一致造成的。要解决此问题，请确保您正在聚合的字段的基数为1。如果是多值字段，请考虑使用其他字段或调整数据模型。或者，您可以使用支持更高基数的其他类型的聚合。
日志上下文 #  日志 “Aggregation [” + name() + “] must have cardinality 1 but was [” + cardinality + “]” 类名是 GlobalAggregatorFactory.java. 我们从Elasticsearch源代码中提取了以下内容，供那些寻求深入上下文的人使用：
if (cardinality != CardinalityUpperBound.ONE) { throw new AggregationExecutionException("Aggregation [" + name() + "] must have cardinality 1 but was [" + cardinality + "]"); } return new GlobalAggregator(name; factories; context; metadata); "
---



> **版本：** 7.9-8.9


简而言之，当尝试执行Elasticsearch聚合操作时，如果基数（唯一值的数量）不为1，就会出现此错误。这可能是由于配置错误或数据不一致造成的。要解决此问题，请确保您正在聚合的字段的基数为1。如果是多值字段，请考虑使用其他字段或调整数据模型。或者，您可以使用支持更高基数的其他类型的聚合。

日志上下文
-----------

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

```java
if (cardinality != CardinalityUpperBound.ONE) {
    throw new AggregationExecutionException("Aggregation [" + name() + "] must have cardinality 1 but was [" + cardinality + "]");
}
return new GlobalAggregator(name; factories; context; metadata);
```