parsing_exception: Failed to parse the search request / query DSL（无法解析搜索请求/query DSL）

含义

提交的查询体（query DSL）无法解析。由于请求的 JSON 结构或查询语法与 Elasticsearch 预期的格式不符，查询无法运行。

原因

无效的 JSON、位置错误/未知的查询键、查询类型（例如 bool、range）的结构使用错误、在版本之间被移除/更改的字段名，或多出/缺少括号。在手写或动态构造的查询中很常见。

解决方法

根据错误消息中的行/位置提示检查查询体；确认 JSON 有效。将 query DSL 结构与官方参考进行比较（bool/must/filter 的位置等）。更新在版本升级中被移除的语法。逐步简化查询以定位出错部分；尽可能使用客户端库的查询构造器。