---
title: "Positions increment gap 必须为正数但得到负数 – 如何解决此 Elasticsearch 异常"
date: 2026-02-09
lastmod: 2026-02-09
description: "当 Elasticsearch 中的 positions_increment_gap 参数被设置为负值时会发生此错误。该参数用于控制字段的每个实例之间应插入的虚假词条位置数量。"
tags: ["索引映射", "参数配置", "异常处理"]
summary: " 版本： 6.8-7.9
 简而言之，当 Elasticsearch 中的"positions_increment_gap"参数被设置为负值时，会发生此错误。该参数用于控制字段的每个实例之间应插入的虚假词条位置数量。它必须是一个正数。要解决此问题，你应该检查 Elasticsearch 设置或映射配置，并确保"positions_increment_gap"参数设置为正值。如果不是，请将其更改为正数并重新启动 Elasticsearch。
日志上下文 #  日志"[positions_increment_gap] must be positive; got"的类名是 AnnotatedTextFieldMapper.java。我们从 Elasticsearch 源代码中提取了以下内容，以便为那些寻求深入了解上下文的人提供参考：
builder = this; } public Builder positionIncrementGap(int positionIncrementGap) { if (positionIncrementGap < 0) { throw new MapperParsingException("[positions_increment_gap] must be positive; got " + positionIncrementGap); } this.positionIncrementGap = positionIncrementGap; return this; } "
---



> **版本：** 6.8-7.9


简而言之，当 Elasticsearch 中的"positions_increment_gap"参数被设置为负值时，会发生此错误。该参数用于控制字段的每个实例之间应插入的虚假词条位置数量。它必须是一个正数。要解决此问题，你应该检查 Elasticsearch 设置或映射配置，并确保"positions_increment_gap"参数设置为正值。如果不是，请将其更改为正数并重新启动 Elasticsearch。

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

日志"[positions_increment_gap] must be positive; got"的类名是[AnnotatedTextFieldMapper.java。](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)我们从 Elasticsearch 源代码中提取了以下内容，以便为那些寻求深入了解上下文的人提供参考：

```java
builder = this;
 }  public Builder positionIncrementGap(int positionIncrementGap) {
 if (positionIncrementGap < 0) {
 throw new MapperParsingException("[positions_increment_gap] must be positive; got " + positionIncrementGap);
 }
 this.positionIncrementGap = positionIncrementGap;
 return this;
 }
```