适用版本： 6.8-8.x
1. 错误异常的基本描述 #
could not parse watch [<id>]; unexpected token [<token>] 表示解析器在期望读取字段名的位置，实际遇到了不应该出现的 token。
根据日志上下文，这个异常发生在 currentFieldName == null 的分支，也就是解析器还没有读到合法字段名时，就先看到了别的内容。
2. 从日志可判断出的根因 #
这类错误通常意味着 Watch 顶层结构不是一个正常的对象字段序列，常见原因包括：
- 顶层传成了数组、字符串、数字或布尔值
- 对象内部出现了多余逗号、非法分隔符或损坏内容
- Watch JSON 前后被拼接了额外内容
- 模板生成后，字段名位置变成了空值或无效 token
3. 典型错误示例 #
下面这种请求把顶层写成了数组，不是合法的 Watch 对象：
[
{
"trigger": {
"schedule": {
"interval": "1m"
}
}
}
]
下面这种请求在对象外有多余 token，也可能触发类似问题：
{"trigger":{"schedule":{"interval":"1m"}}} true
4. 正确写法 #
Watch 顶层必须是一个对象，并且字段名合法，例如：
{
"trigger": {
"schedule": {
"interval": "1m"
}
},
"input": {
"simple": {
"payload": {
"env": "prod"
}
}
},
"condition": {
"always": {}
},
"actions": {
"log": {
"logging": {
"text": "watch parsed"
}
}
}
}
5. 推荐排查步骤 #
- 把最终提交给 Elasticsearch 的 body 单独保存下来，用 JSON 校验工具验证。
- 如果是模板生成结果，检查变量替换后是否出现数组、裸值或尾部脏数据。
- 如果经过网关或脚本拼接，确认没有在 body 前后额外附加内容。
- 若问题来自历史 Watch，导出原文并重新以合法 JSON 方式写回。
6. 处理建议 #
- 顶层只允许标准 Watch 对象，不要包额外数组或包装层。
- 动态生成 JSON 时避免字符串拼接，优先使用结构化序列化。
- 对提交前的 JSON 增加 schema 或最小字段校验。
相关错误 #
附：日志上下文 #
if (token == null) {
throw new ElasticsearchParseException("could not parse watch [{}]. null token", id);
} else if (token == XContentParser.Token.FIELD_NAME) {
currentFieldName = parser.currentName();
} else if (currentFieldName == null) {
throw new ElasticsearchParseException("could not parse watch [{}]; unexpected token [{}]", id, token);
} else if (WatchField.TRIGGER.match(currentFieldName, parser.getDeprecationHandler())) {
trigger = triggerService.parseTrigger(id, parser);
} else if (WatchField.INPUT.match(currentFieldName, parser.getDeprecationHandler())) {
input = inputRegistry.parse(id, parser);
} else if (WatchField.CONDITION.match(currentFieldName, parser.getDeprecationHandler())) {
