parsing_exception: Failed to parse the search request / query DSL (no se pudo analizar la solicitud de búsqueda / el query DSL)

¿Qué significa?

No se pudo analizar el cuerpo de la consulta enviado (query DSL). La consulta no pudo ejecutarse porque la estructura JSON de la solicitud o la sintaxis de la consulta no coinciden con el formato que espera Elasticsearch.

¿Por qué ocurre?

JSON no válido, claves de consulta mal colocadas/desconocidas, un tipo de consulta (p. ej., bool, range) usado con una estructura incorrecta, un nombre de campo eliminado/cambiado entre versiones, o un corchete de más/de menos. Habitual con consultas escritas a mano o construidas dinámicamente.

Cómo solucionarlo

Revise el cuerpo de la consulta usando la indicación de línea/posición del mensaje de error; verifique que el JSON sea válido. Compare la estructura del query DSL con la referencia oficial (ubicación de bool/must/filter, etc.). Actualice la sintaxis eliminada en las actualizaciones de versión. Simplifique la consulta paso a paso para aislar la parte defectuosa; use el query builder de la biblioteca cliente siempre que sea posible.