not_x_content_exception: Compressor detection error / body is not valid content (erreur de détection du compresseur / corps de requête invalide)

Que signifie cette erreur ?

Elasticsearch n'a pas pu reconnaître le corps de la requête comme un contenu structuré valide (XContent comme JSON). Les données envoyées ne sont pas au format attendu ou sont corrompues.

Cause

Le corps de la requête est un JSON invalide ; en-tête Content-Type erroné ou absent (application/json non envoyé) ; corps envoyé par erreur compressé/binaire ; ou JSON simple envoyé à des endpoints comme _bulk qui attendent du JSON délimité par des retours à la ligne (NDJSON). Les erreurs d'échappement/d'encodage le déclenchent aussi.

Comment la corriger

Vérifiez que le corps de la requête est un JSON valide et envoyez l'en-tête Content-Type: application/json. Pour l'endpoint _bulk, utilisez du NDJSON, où chaque ligne est un objet JSON distinct et la dernière ligne se termine par un retour à la ligne (Content-Type: application/x-ndjson). Assurez-vous que votre bibliothèque cliente sérialise correctement le corps. Si vous utilisez la compression, envoyez l'en-tête Content-Encoding approprié.