parsing_exception: Failed to parse the search request / query DSL (não foi possível interpretar a requisição de busca / o query DSL)

O que significa?

O corpo da consulta enviado (query DSL) não pôde ser interpretado. A consulta não pôde ser executada porque a estrutura JSON da requisição ou a sintaxe da consulta não corresponde ao formato que o Elasticsearch espera.

Por que acontece?

JSON inválido, chaves de consulta fora do lugar/desconhecidas, um tipo de consulta (por exemplo, bool, range) usado com a estrutura errada, um nome de campo removido/alterado entre versões, ou um colchete sobrando/faltando. Comum com consultas escritas à mão ou montadas dinamicamente.

Como resolver

Verifique o corpo da consulta usando a indicação de linha/posição na mensagem de erro; confirme que o JSON é válido. Compare a estrutura do query DSL com a referência oficial (posicionamento de bool/must/filter etc.). Atualize a sintaxe removida em upgrades de versão. Simplifique a consulta aos poucos para isolar a parte com defeito; use o consulta builder da biblioteca cliente sempre que possível.