适用版本： 6.8-8.x
1. 错误异常的基本描述 #
could not parse watch execution request. unexpected boolean field [...] 表示 Execute Watch 请求体中出现了一个布尔值字段，但这个字段名不在解析器允许的范围内。
从源码可见，布尔值分支只接受非常有限的几个字段，例如 ignore_condition 和 record_execution。如果你传了别的布尔字段，即使 JSON 语法本身完全正确，也会被 Watcher 拒绝。
常见现象 #
- 接口返回
400 bad request。 - 报错里会直接带出具体字段名。
- 多见于手写 JSON、SDK 参数映射错误或升级后沿用旧字段名。
2. 为什么会发生这个错误 #
保留代码显示：当解析器读到 VALUE_BOOLEAN 时，只匹配两个布尔字段。除此之外的任何布尔字段，都会进入 unexpected boolean field 分支。
常见场景包括：
- 把自定义控制字段直接放进 Execute Watch 请求顶层。
- 错把对象字段写成了
true/false。 - 某些中间层把开关类参数自动序列化进请求体。
- 旧版本字段名在新版本中不再被接受。
3. 如何排查和解决这个异常和解决这个异常 #
- 在报错中找到方括号里的字段名。
- 对照当前版本 Execute Watch API 的允许字段，确认它是否真的应该是布尔值。
- 如果该字段本来属于业务侧控制参数，就不要直接透传给 Elasticsearch。
- 如果它本来不是布尔值，检查调用方序列化逻辑是否写错。
- 使用最小请求体重试，只保留
record_execution、ignore_condition等已知字段做对照验证。
排查重点 #
- 不要把 watch 定义里的字段和 execute request 的控制字段混在一起。
- 很多动态语言客户端会把空对象、空数组或开关参数自动转换为布尔值，需要重点看最终请求体。
4. 如何解决这个错误 #
修复方法 #
- 删除未被支持的布尔字段。
- 把字段移动到应用自己的控制层，而不是发给 Elasticsearch。
- 如果字段语义正确但类型错误，改回 Elasticsearch 期望的数据类型。
- 在发请求前增加字段白名单校验。
5. 小结 #
这个异常不是“布尔值不能用”，而是“布尔值出现在了不该出现的位置”。只要确认字段名是否属于 Execute Watch API 的合法布尔字段集合，基本就能快速修复。
相关错误 #
- could-not-parse-watch-execution-request-how-to-solve-this-elasticsearch-exception
- could-not-parse-watch-unexpected-field-how-to-solve-this-elasticsearch-exception
- could-not-parse-input-for-watch-missing-required-field-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
if (IGNORE_CONDITION.match(currentFieldName, parser.getDeprecationHandler())) {
builder.setIgnoreCondition(parser.booleanValue());
} else if (RECORD_EXECUTION.match(currentFieldName, parser.getDeprecationHandler())) {
builder.setRecordExecution(parser.booleanValue());
} else {
throw new ElasticsearchParseException("could not parse watch execution request. unexpected boolean field [{}]",
currentFieldName);
}
} else if (token == XContentParser.Token.START_OBJECT) {
if (Field.ALTERNATIVE_INPUT.match(currentFieldName, parser.getDeprecationHandler())) {
builder.setAlternativeInput(parser.map());
