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 の配置など)。バージョンアップで削除された構文を更新する。クエリを段階的に単純化して誤った部分を切り分ける。可能であればクライアントライブラリのクエリビルダを使用する。