parsing_exception: Failed to parse the search request / query DSL (échec de l'analyse de la requête de recherche / du query DSL)

Que signifie cette erreur ?

Le corps de requête envoyé (query DSL) n'a pas pu être analysé. La requête n'a pas pu s'exécuter car la structure JSON de la requête ou la syntaxe de la requête ne correspond pas au format attendu par Elasticsearch.

Cause

JSON invalide, clés de requête mal placées/inconnues, type de requête (par ex. bool, range) utilisé avec une mauvaise structure, nom de champ supprimé/modifié d'une version à l'autre, ou accolade en trop/manquante. Fréquent avec les requêtes écrites à la main ou construites dynamiquement.

Comment la corriger

Vérifiez le corps de la requête à l'aide de l'indication de ligne/position du message d'erreur ; vérifiez que le JSON est valide. Comparez la structure du query DSL avec la référence officielle (placement de bool/must/filter, etc.). Mettez à jour la syntaxe supprimée lors des montées de version. Simplifiez la requête progressivement pour isoler la partie fautive ; utilisez le query builder de la bibliothèque cliente lorsque c'est possible.