---
title: "RareTerms 聚合不支持浮点类型字段 – 如何解决此 Elasticsearch 异常"
date: 2026-01-10
lastmod: 2026-01-10
description: "在 Elasticsearch 中对浮点类型字段使用 RareTerms 聚合时会抛出异常。本文介绍了该错误的成因及多种解决方案，包括更改字段类型、使用其他聚合类型或在索引前对浮点值进行取整处理。"
tags: ["聚合查询", "字段类型", "异常处理"]
summary: " 版本： 7.3-7.7
 简而言之，当您在 Elasticsearch 中对浮点类型的字段尝试使用 RareTerms 聚合时，会出现此错误。RareTerms 聚合专为处理离散值而设计，不支持连续值。要解决此问题，如果可能的话，您可以将字段类型更改为非浮点类型，或者使用支持浮点字段的其他聚合类型，例如 Histogram 或 Percentiles。此外，如果精度不是关键因素，您还可以在索引之前将浮点值四舍五入为整数。
日志上下文
日志 “RareTerms aggregation does not support floating point fields.” 的类名是 RareTermsAggregatorFactory.java。 我们从 Elasticsearch 源代码中提取了以下内容，为寻求深入上下文的用户提供了参考：
} if (valuesSource instanceof ValuesSource.Numeric) { IncludeExclude.LongFilter longFilter = null; if (((ValuesSource.Numeric) valuesSource).isFloatingPoint()) { throw new AggregationExecutionException("RareTerms aggregation does not support floating point fields."); } if (includeExclude != null) { longFilter = includeExclude.convertToLongFilter(config.format()); } return new LongRareTermsAggregator(name; factories; (ValuesSource.Numeric) valuesSource; config.format(); "
---



> **版本：** 7.3-7.7


简而言之，当您在 Elasticsearch 中对浮点类型的字段尝试使用 RareTerms 聚合时，会出现此错误。RareTerms 聚合专为处理离散值而设计，不支持连续值。要解决此问题，如果可能的话，您可以将字段类型更改为非浮点类型，或者使用支持浮点字段的其他聚合类型，例如 Histogram 或 Percentiles。此外，如果精度不是关键因素，您还可以在索引之前将浮点值四舍五入为整数。

日志上下文

日志 "RareTerms aggregation does not support floating point fields." 的类名是 [RareTermsAggregatorFactory.java。](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/) 我们从 Elasticsearch 源代码中提取了以下内容，为寻求深入上下文的用户提供了参考：

```java
    }  if (valuesSource instanceof ValuesSource.Numeric) {
        IncludeExclude.LongFilter longFilter = null;
        if (((ValuesSource.Numeric) valuesSource).isFloatingPoint()) {
            throw new AggregationExecutionException("RareTerms aggregation does not support floating point fields.");
        }
        if (includeExclude != null) {
            longFilter = includeExclude.convertToLongFilter(config.format());
        }
        return new LongRareTermsAggregator(name; factories; (ValuesSource.Numeric) valuesSource; config.format();
```