---
title: "指定的连接键数量不一致：期望但实际找到——如何解决此Elasticsearch异常"
date: 2026-02-16
lastmod: 2026-02-16
description: "当Elasticsearch查询中指定的连接键数量与期望数量不匹配时，会引发此错误。通常是由于拼写错误、语法错误或对连接操作的误解导致的。"
tags: ["连接键", "查询异常", "语法错误"]
summary: "版本： 7.8-7.15
 简而言之，当 Elasticsearch 查询中指定的连接键数量与期望数量不匹配时，就会发生此错误。这可能是由于拼写错误、语法不正确或对连接操作的误解导致的。要解决此问题，您应该首先验证查询中的连接键。确保连接键的数量与期望数量匹配。如果错误仍然存在，请检查查询的语法。理解 Elasticsearch 中连接操作的工作原理也很重要，因为误用会导致此类错误。
日志上下文 #  日志 “Inconsistent number of join keys specified; expected [{}] but found [{}]” 的类名是 LogicalPlanBuilder.java. 我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入了解上下文的人参考：
} else { if (numberOfKeys != keySize) { Source src = source(joinTermCtx.by != null ? joinTermCtx.by : joinTermCtx); int expected = numberOfKeys - parentJoinKeys.size(); int found = keySize - parentJoinKeys.size(); throw new ParsingException(src; "Inconsistent number of join keys specified; expected [{}] but found [{}]"; expected; found); } } queries."
---


> **版本：** 7.8-7.15


简而言之，当 Elasticsearch 查询中指定的连接键数量与期望数量不匹配时，就会发生此错误。这可能是由于拼写错误、语法不正确或对连接操作的误解导致的。要解决此问题，您应该首先验证查询中的连接键。确保连接键的数量与期望数量匹配。如果错误仍然存在，请检查查询的语法。理解 Elasticsearch 中连接操作的工作原理也很重要，因为误用会导致此类错误。

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

日志 "Inconsistent number of join keys specified; expected [{}] but found [{}]" 的类名是 [LogicalPlanBuilder.java.](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/) 我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入了解上下文的人参考：

```java
} else {
    if (numberOfKeys != keySize) {
        Source src = source(joinTermCtx.by != null ? joinTermCtx.by : joinTermCtx);
        int expected = numberOfKeys - parentJoinKeys.size();
        int found = keySize - parentJoinKeys.size();
        throw new ParsingException(src; "Inconsistent number of join keys specified; expected [{}] but found [{}]"; expected;
            found);
    }
}
queries.add(joinTerm);
}
```