---
title: "构建时检测到未使用的参数 - 如何解决此 Elasticsearch 异常"
date: 2026-01-20
lastmod: 2026-01-20
description: "Elasticsearch查询中存在未使用的参数导致的错误及解决方案"
tags: ["Elasticsearch", "查询参数", "参数错误", "版本兼容"]
summary: " 版本： 7.12-7.15
 简而言之，当Elasticsearch查询中存在未被使用的参数时，就会出现此错误。这可能是由于拼写错误、参数名称不正确或不必要的参数造成的。要解决此问题，您应该检查查询并删除或更正任何未使用或不正确的参数。此外，确保使用的参数与您使用的Elasticsearch版本兼容，因为某些参数可能在较新版本中已被弃用或更改。
日志上下文 #  日志"Unused parameters {} detected when building [{}]“的类名是 FunctionRegistry.java。我们从Elasticsearch源代码中提取了以下内容，供那些寻求深入上下文的人使用：
Check.isTrue(names.length > 0; "At least one name must be provided for the function"); String primaryName = names[0]; Listaliases = Arrays.asList(names).subList(1; names.length); FunctionDefinition.Builder realBuilder = (uf; cfg; extras) -> { if (CollectionUtils.isEmpty(extras) == false) { throw new ParsingException(uf.source(); "Unused parameters {} detected when building [{}]"; Arrays.toString(extras); primaryName); } try { return builder.build(uf.source(); uf.children(); cfg); "
---



> **版本：** 7.12-7.15

简而言之，当Elasticsearch查询中存在未被使用的参数时，就会出现此错误。这可能是由于拼写错误、参数名称不正确或不必要的参数造成的。要解决此问题，您应该检查查询并删除或更正任何未使用或不正确的参数。此外，确保使用的参数与您使用的Elasticsearch版本兼容，因为某些参数可能在较新版本中已被弃用或更改。

## 日志上下文

日志"Unused parameters {} detected when building [{}]"的类名是[FunctionRegistry.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从Elasticsearch源代码中提取了以下内容，供那些寻求深入上下文的人使用：

```java
Check.isTrue(names.length > 0; "At least one name must be provided for the function");
String primaryName = names[0];
Listaliases = Arrays.asList(names).subList(1; names.length);
FunctionDefinition.Builder realBuilder = (uf; cfg; extras) -> {
    if (CollectionUtils.isEmpty(extras) == false) {
        throw new ParsingException(uf.source(); "Unused parameters {} detected when building [{}]";
        Arrays.toString(extras);
        primaryName);
    }
    try {
        return builder.build(uf.source(); uf.children(); cfg);
```