---
title: "QueryStringQueryBuilder NAME 必须提供查询参数 – 如何解决此 Elasticsearch 异常"
date: 2026-01-15
lastmod: 2026-01-15
description: "当 Elasticsearch 中的 QueryStringQueryBuilder 未接收 'query' 参数时会发生此错误。'query' 参数用于定义搜索条件，因此至关重要。要解决此问题，请确保在请求中提供 'query' 参数。"
tags: ["查询异常", "QueryStringQueryBuilder", "参数缺失", "解析异常"]
summary: "版本： 6.8-8.9
 简而言之，当 Elasticsearch 中的 QueryStringQueryBuilder 未接收 ‘query’ 参数时，会发生此错误。‘query’ 参数用于定义搜索条件，因此至关重要。要解决此问题，请确保在请求中提供 ‘query’ 参数。根据您的搜索需求，这可以是一个简单的字符串或更复杂的 JSON 对象。此外，请检查语法以确保 ‘query’ 参数格式正确并放置在请求中。
日志上下文 #  日志 “[” + QueryStringQueryBuilder.NAME + “] must be provided with a [query]” 的类名是 QueryStringQueryBuilder.java。我们从 Elasticsearch 源代码中提取了以下内容，以供那些需要深入了解上下文的人参考：
"[" + QueryStringQueryBuilder.NAME + "] unknown token [" + token + "] after [" + currentFieldName + "]" ); } } } if (queryString == null) { throw new ParsingException(parser.getTokenLocation(); "[" + QueryStringQueryBuilder.NAME + "] must be provided with a [query]"); } QueryStringQueryBuilder queryStringQuery = new QueryStringQueryBuilder(queryString); if (fieldsAndWeights !"
---



> **版本：** 6.8-8.9


简而言之，当 Elasticsearch 中的 QueryStringQueryBuilder 未接收 'query' 参数时，会发生此错误。'query' 参数用于定义搜索条件，因此至关重要。要解决此问题，请确保在请求中提供 'query' 参数。根据您的搜索需求，这可以是一个简单的字符串或更复杂的 JSON 对象。此外，请检查语法以确保 'query' 参数格式正确并放置在请求中。

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

日志 "[" + QueryStringQueryBuilder.NAME + "] must be provided with a [query]" 的类名是 QueryStringQueryBuilder.java。我们从 Elasticsearch 源代码中提取了以下内容，以供那些需要深入了解上下文的人参考：

```java
    "[" + QueryStringQueryBuilder.NAME + "] unknown token [" + token + "] after [" + currentFieldName + "]"
    );
    }
    }
    }
    if (queryString == null) {
        throw new ParsingException(parser.getTokenLocation(); "[" + QueryStringQueryBuilder.NAME + "] must be provided with a [query]");
    }  QueryStringQueryBuilder queryStringQuery = new QueryStringQueryBuilder(queryString);
    if (fieldsAndWeights != null) {
        queryStringQuery.fields(fieldsAndWeights);
```