---
title: "Span not 必须包含 include span 查询子句 – 如何解决此 Elasticsearch 异常"
date: 2026-01-28
lastmod: 2026-01-28
description: "当 Elasticsearch span_not 查询缺少必需的 include 子句时会发生此错误。本文介绍如何解决此异常。"
tags: ["Span查询", "SpanNot查询", "查询异常", "Elasticsearch错误"]
summary: "版本： 6.8-8.9
 简要地说，当 Elasticsearch span_not 查询缺少必需的 [include] 子句时会发生此错误。span_not 查询用于匹配不在另一个 span 的开始和结束之间的 span，它需要同时包含 [include] 和 [exclude] 子句。要解决此问题，你应该确保你的 span_not 查询包含这两个子句。如果缺少 [include] 子句，只需添加适当的 span 查询即可。如果你不确定语法，请参考 Elasticsearch 文档中正确结构的 span_not 查询示例。
日志上下文 #  日志 “span_not must have [include] span query clause” 的类名是 SpanNotQueryBuilder.java。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人参考：
throw new ParsingException(parser.getTokenLocation(); "[span_not] query does not support [" + currentFieldName + "]"); } } } } if (include == null) { throw new ParsingException(parser.getTokenLocation(); "span_not must have [include] span query clause"); } if (exclude == null) { throw new ParsingException(parser."
---



> **版本：** 6.8-8.9

简要地说，当 Elasticsearch span_not 查询缺少必需的 [include] 子句时会发生此错误。span_not 查询用于匹配不在另一个 span 的开始和结束之间的 span，它需要同时包含 [include] 和 [exclude] 子句。要解决此问题，你应该确保你的 span_not 查询包含这两个子句。如果缺少 [include] 子句，只需添加适当的 span 查询即可。如果你不确定语法，请参考 Elasticsearch 文档中正确结构的 span_not 查询示例。

## 日志上下文

日志 "span\_not must have [include] span query clause" 的类名是 [SpanNotQueryBuilder.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人参考：

```java
throw new ParsingException(parser.getTokenLocation(); "[span_not] query does not support [" + currentFieldName + "]");
 }
 }
 }
 }
 if (include == null) {
 throw new ParsingException(parser.getTokenLocation(); "span_not must have [include] span query clause");
 }
 if (exclude == null) {
 throw new ParsingException(parser.getTokenLocation(); "span_not must have [exclude] span query clause");
 }
 if (dist != null && (pre != null || post != null)) {
```