---
title: "TermsQueryBuilder NAME 查询需要字段名 - 如何解决此 Elasticsearch 异常"
date: 2026-03-19
lastmod: 2026-03-19
description: "此错误发生在执行 Terms 查询时未指定字段名。Elasticsearch 的 Terms 查询用于在特定字段中查找包含确切指定词条的文档。如果不提供字段名，Elasticsearch 不知道在哪里查找词条，从而引发错误。"
tags: ["Terms查询", "查询异常", "字段名", "解析异常"]
summary: "版本： 6.8-7.15
 简要地说，此错误发生在执行 Terms 查询时未指定字段名。Elasticsearch 中的 Terms 查询用于查找在特定字段中包含确切指定词条的文档。如果不提供字段名，Elasticsearch 不知道在哪里查找词条，因此会报错。要解决此问题，请确保在 Terms 查询中提供了有效的字段名。此外，请检查查询语法以确保其正确性，并且您查询的字段确实存在于索引中。
日志上下文 #  日志 “[” + TermsQueryBuilder.NAME + “] query requires a field name; " 类名是 TermsQueryBuilder.java。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人使用：
"[" + TermsQueryBuilder.NAME + "] unknown token [" + token + "] after [" + currentFieldName + "]"); } } if (fieldName == null) { throw new ParsingException(parser.getTokenLocation(), "[" + TermsQueryBuilder.NAME + "] query requires a field name; " + "followed by array of terms or a document lookup specification"); } return new TermsQueryBuilder(fieldName, values, termsLookup) ."
---




> **版本：** 6.8-7.15


简要地说，此错误发生在执行 Terms 查询时未指定字段名。Elasticsearch 中的 Terms 查询用于查找在特定字段中包含确切指定词条的文档。如果不提供字段名，Elasticsearch 不知道在哪里查找词条，因此会报错。要解决此问题，请确保在 Terms 查询中提供了有效的字段名。此外，请检查查询语法以确保其正确性，并且您查询的字段确实存在于索引中。

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

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

```java
"[" + TermsQueryBuilder.NAME + "] unknown token [" + token + "] after [" + currentFieldName + "]");
 }
 }  if (fieldName == null) {
 throw new ParsingException(parser.getTokenLocation(), "[" + TermsQueryBuilder.NAME + "] query requires a field name; " +
 "followed by array of terms or a document lookup specification");
 }  return new TermsQueryBuilder(fieldName, values, termsLookup)
 .boost(boost)
```