not_x_content_exception: Compressor detection error / body is not valid content (error de detección del compresor / el cuerpo no es contenido válido)

¿Qué significa?

Elasticsearch no pudo reconocer el cuerpo de la solicitud como contenido estructurado válido (XContent como JSON). Los datos enviados no tienen el formato esperado o están corruptos.

¿Por qué ocurre?

El cuerpo de la solicitud es JSON no válido; una cabecera Content-Type incorrecta o ausente (no se envió application/json); el cuerpo se envió por accidente comprimido/en binario; o se envió JSON normal a endpoints como _bulk que esperan JSON delimitado por saltos de línea (NDJSON). Los errores de escape/codificación también lo provocan.

Cómo solucionarlo

Verifique que el cuerpo de la solicitud sea JSON válido y envíe la cabecera Content-Type: application/json. Para el endpoint _bulk use NDJSON, donde cada línea es un objeto JSON independiente y la última línea termina con un salto de línea (Content-Type: application/x-ndjson). Asegúrese de que su biblioteca cliente serialice el cuerpo correctamente. Si usa compresión, envíe la cabecera Content-Encoding correspondiente.