Unexpected trailing characters found - 如何解决此 Elasticsearch 异常

适用版本： 6.8-7.15

1. 错误异常的基本描述 #

Unexpected trailing characters found 表示 Elasticsearch 在解析时间间隔字符串时，发现有效时间间隔后还有额外的未识别字符。

从源码可见，这个异常在时间间隔解析路径中抛出，当解析完成后字符串还有剩余字符时触发。

典型报错 #

ParsingException: Invalid interval [1dxyz]: unexpected trailing characters found [xyz]

2. 为什么会发生这个错误 #

• 时间间隔格式错误：在有效的时间间隔后添加了额外字符。
• 单位拼写错误：时间单位拼写错误或使用了不支持的单位。
• 多个时间间隔拼接：错误地将多个时间间隔拼接在一起。
• 多余的空格或符号：时间间隔字符串中包含多余的字符。

3. 排查步骤 #

1. 检查时间间隔格式：确认使用正确的时间间隔语法。
2. 验证时间单位：确认使用支持的时间单位。
3. 移除多余字符：删除时间间隔后的额外字符。
4. 使用标准格式：按照 Elasticsearch 标准格式书写。

4. 修复建议 #

方案一：使用正确的时间间隔格式 #

确保时间间隔格式正确：

// 错误示例
{
  "interval": "1dxyz"
}

// 正确示例
{
  "interval": "1d"
}

方案二：使用支持的时间单位 #

Elasticsearch 支持的时间单位：

d: 天 (days)
h: 小时 (hours)
m: 分钟 (minutes)
s: 秒 (seconds)
ms: 毫秒 (milliseconds)
micros: 微秒 (microseconds)
nanos: 纳秒 (nanoseconds)
w: 周 (weeks), M: 月 (months), y: 年 (years) - 仅适用于特定上下文

方案三：分离多个时间间隔 #

如果需要多个时间间隔，分开指定：

// 错误
{ "interval": "1d2h" }

// 正确 - 使用复合时间间隔
{ "interval": "1d" }
// 或在聚合中使用日期直方图的 extended_bounds

5. 小结 #

Unexpected trailing characters found 通常意味着时间间隔字符串格式不正确。排查时应优先检查时间间隔语法和单位。

相关错误 #

• parsing-exception-how-to-solve-this-elasticsearch-exception
• invalid-interval-how-to-solve-this-elasticsearch-exception
• date-math-exception-how-to-solve-this-elasticsearch-exception

附：日志上下文 #

startToken = endToken;
}
}  if (endToken <= string.length() - 1) {
    throw new ParsingException(source, invalidIntervalMessage(string) + ": unexpected trailing characters found [{}]",
        string.substring(endToken));
}  TemporalAmount interval = units.get(0) == TimeUnit.YEAR || units.get(0) == TimeUnit.MONTH ? Period.ZERO : Duration.ZERO;