Spring Boot集成Elasticsearch 8+遭遇x_content_parse_exception错误

问题分析 #

你遇到的400错误根源是Odata解析器生成的查询JSON包含了多余的转义反斜杠（\），Elasticsearch无法识别这种被二次转义的JSON格式。从错误日志可见，所有双引号前都被额外添加了\，比如\"bool\"，这违背了标准JSON的语法要求。

解决方案 #

1. 修复Odata解析器的JSON生成逻辑 #

确保解析器直接输出原生JSON结构，而非转义后的JSON字符串：

• 若使用Jackson等序列化工具，避免对已序列化完成的JSON字符串再次执行序列化操作；
• 检查代码中是否存在额外的字符串转义步骤，直接移除该多余操作。

正确的查询JSON示例（无转义反斜杠）：

{
  "bool" : {
    "must" : [
      {
        "match" : {
          "degreeLevel" : {
            "query" : "masters",
            "operator" : "OR",
            "prefix_length" : 0,
            "max_expansions" : 50,
            "fuzzy_transpositions" : true,
            "lenient" : false,
            "zero_terms_query" : "NONE",
            "auto_generate_synonyms_phrase_query" : true,
            "boost" : 1.0
          }
        }
      }
    ]
  }
}

2. 使用Spring Data Elasticsearch API构建查询（推荐） #

避免手动拼接JSON字符串，直接用框架提供的查询构建器构造查询，自动适配Elasticsearch 8+的语法要求，彻底规避转义问题：

import org.springframework.data.elasticsearch.client.elc.NativeQuery;
import org.springframework.data.elasticsearch.core.ElasticsearchOperations;
import org.springframework.data.elasticsearch.core.query.Query;
import co.elastic.clients.elasticsearch._types.query_dsl.BoolQuery;
import co.elastic.clients.elasticsearch._types.query_dsl.MatchQuery;

// 注入ElasticsearchOperations实例
private final ElasticsearchOperations elasticsearchOperations;

public void queryByDegreeLevel() {
    // 构建match子查询
    MatchQuery matchQuery = MatchQuery.of(m -> m
            .field("degreeLevel")
            .query("masters")
            .operator(co.elastic.clients.elasticsearch._types.query_dsl.Operator.OR)
    )._toQuery();

    // 组装bool查询
    BoolQuery boolQuery = BoolQuery.of(b -> b.must(matchQuery))._toQuery();

    // 构造NativeQuery并执行查询
    Query query = NativeQuery.builder().withQuery(boolQuery).build();
    var results = elasticsearchOperations.search(query, YourEntityClass.class);
}

3. 验证请求体正确性 #

通过开启客户端日志，查看实际发送给Elasticsearch的请求内容，确认无多余转义符。在application.yml中添加日志配置：

logging:
  level:
    org.springframework.data.elasticsearch.client: DEBUG

内容的提问来源于stack exchange，提问作者user23994209