适用版本： 6.8-7.15
1. 错误异常的基本描述 #
unknown key for a token in [currentFieldName] 表示 Elasticsearch 在解析某个配置对象时，发现当前字段后面跟着一个不被该解析器接受的 token 类型，因此无法把它识别成合法参数。
从当前页面保留的源码来看，异常本质是 字段后的值类型或 JSON 结构不符合预期。它并不一定只出现在 Ingest Processor，任何基于 XContentParser 按 token 分支解析的配置对象都可能抛出这一类错误。
典型报错 #
ParsingException: Unknown key for a VALUE_BOOLEAN in [field_name]
2. 为什么会发生这个错误 #
- 值类型不对：字段后面本应是字符串、数字、数组或对象，却传成了别的 token。
- 结构层级有误：本应在对象内部的字段被直接写成了标量值。
- 配置键和值混用：解析器在期望继续读取子字段时，实际读到了不可接受的 token。
- 版本或接口差异：不同版本支持的字段和值类型不完全一致。
3. 排查步骤 #
- 看报错里的 token 类型：例如
VALUE_BOOLEAN、START_ARRAY、START_OBJECT，先判断是不是值类型错了。 - 定位字段名：结合
currentFieldName找到具体是哪个字段后的值不合法。 - 对照接口示例：确认该字段后面应该跟的是标量、数组还是对象。
- 打印最终请求体：如果配置由程序生成，不要只看模板变量，直接看序列化后的 JSON。
4. 修复建议 #
方案一：修正字段后的 token 类型 #
确保字段后的值与接口要求一致：
// 错误示例
{
"processors": [
{
"set": {
"field": "my_field",
"ignore_failure": "true"
}
}
]
}
// 正确示例
{
"processors": [
{
"set": {
"field": "my_field",
"ignore_failure": true
}
}
]
}
方案二：把值改回对象或数组结构 #
如果某个字段要求的是对象定义，而你直接给了布尔值、字符串或数字，也会触发类似异常。
5. 小结 #
unknown key for a token in [currentFieldName] 的重点是：当前字段后面的 JSON token 不符合解析器预期。优先检查值类型和层级结构，通常就能快速定位问题。
相关错误 #
- unknown-key-for-a-token-in-how-to-solve-this-elasticsearch-exception
- unknown-key-for-index-template-how-to-solve-this-elasticsearch-exception
- unexpected-token-token-after-fieldname-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
} else {
throw new ParsingException(parser.getTokenLocation(), "Unknown key for a " + token
+ " in [" + currentFieldName + "].", parser.getTokenLocation());
}
} else {
throw new ParsingException(parser.getTokenLocation(), "Unknown key for a " + token + " in [" + currentFieldName + "].",
parser.getTokenLocation());
}
}
} else {
throw new ParsingException(parser.getTokenLocation(), "Expected one of [" + XContentParser.Token.VALUE_BOOLEAN + ", "
