---
title: "NAME getPreferredName 查询不支持 - 如何解决此 Elasticsearch 异常"
date: 2026-03-18
lastmod: 2026-03-18
description: "当尝试使用 Elasticsearch 版本不支持的查询类型或参数时发生的错误。该查询参数未被 Elasticsearch API 识别。解决方法包括更新 Elasticsearch 版本或修改查询以移除或替换不支持的参数。"
tags: ["Elasticsearch", "查询异常", "FieldMaskingSpanQuery", "解析异常"]
summary: "版本： 7.15-7.15
 简而言之，当你尝试使用当前 Elasticsearch 版本不支持的查询类型或参数时，会发生此错误。你尝试使用的查询参数未被 Elasticsearch API 识别。要解决此问题，你可以将 Elasticsearch 版本更新到支持该查询参数的版本，或者修改你的查询以移除或替换不支持的参数。此外，请确保根据 Elasticsearch 文档，你的查询语法和结构是正确的。
日志上下文 #  日志 “[” + NAME.getPreferredName() + “] query does not support [” 类名是 FieldMaskingSpanQueryBuilder.java。我们从 Elasticsearch 源代码中提取了以下内容，为那些寻求深入上下文的人提供参考：
"be of type span query"); } inner = (SpanQueryBuilder) query; checkNoBoost(NAME.getPreferredName(), currentFieldName, parser, inner); } else { throw new ParsingException(parser.getTokenLocation(), "[" + NAME.getPreferredName() + "] query does not support [" + currentFieldName + "]"); } } else { if (AbstractQueryBuilder."
---



> **版本：** 7.15-7.15


简而言之，当你尝试使用当前 Elasticsearch 版本不支持的查询类型或参数时，会发生此错误。你尝试使用的查询参数未被 Elasticsearch API 识别。要解决此问题，你可以将 Elasticsearch 版本更新到支持该查询参数的版本，或者修改你的查询以移除或替换不支持的参数。此外，请确保根据 Elasticsearch 文档，你的查询语法和结构是正确的。

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

日志 "[" + NAME.getPreferredName() + "] query does not support [" 类名是 [FieldMaskingSpanQueryBuilder.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从 Elasticsearch 源代码中提取了以下内容，为那些寻求深入上下文的人提供参考：

```java
"be of type span query");
    }
    inner = (SpanQueryBuilder) query;
    checkNoBoost(NAME.getPreferredName(), currentFieldName, parser, inner);
} else {
    throw new ParsingException(parser.getTokenLocation(), "[" + NAME.getPreferredName() + "] query does not support ["
        + currentFieldName + "]");
}
} else {
    if (AbstractQueryBuilder.BOOST_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
        boost = parser.floatValue();
```