使用NativeSearchQuery查询Elasticsearch时遇未处理查询实现异常

异常原因 #

说白了就是Spring Data Elasticsearch的API混用导致类型不兼容：

• 你用的NativeSearchQuery来自org.springframework.data.elasticsearch.client.erhlc包（旧版High Level Client的配套API），但执行查询的方法（比如ElasticsearchOperations.search()）不识别这个类型，它需要的是org.springframework.data.elasticsearch.core.query.Query接口的标准实现。
• 而把打印的JSON放到@Query注解里时，Spring是直接将JSON原封不动发给Elasticsearch，绕开了API层的类型校验，所以能正常运行。

另外十有八九是依赖版本不匹配——要么spring-data-elasticsearch和Elasticsearch客户端版本不对齐，要么你同时引入了新旧两套API的依赖，导致冲突。

解决方法 #

方法1：用正确的查询构建方式（推荐） #

别手动拼接BoolQueryBuilder和NativeSearchQuery，直接用NativeSearchQueryBuilder组装，保证API统一：

// 构建bool查询逻辑
BoolQueryBuilder boolQuery = QueryBuilders.boolQuery()
    .must(QueryBuilders.termQuery("winlog.event_data.TargetUserName", "USER001"))
    .should(QueryBuilders.termQuery("winlog.event_data.Status", "0x18"))
    .should(QueryBuilders.termQuery("winlog.event_data.Status", "0xC000006A"))
    .minimumShouldMatch(1); // 必须匹配至少一个should条件

// 用Builder生成正确的查询对象
NativeSearchQuery searchQuery = new NativeSearchQueryBuilder()
    .withQuery(boolQuery)
    .build();

// 执行查询
SearchHits<YourEntity> hits = elasticsearchOperations.search(searchQuery, YourEntity.class);

方法2：对齐依赖版本 #

确保spring-data-elasticsearch和elasticsearch-rest-high-level-client的版本严格对应，比如在pom.xml里统一配置：

<properties>
    <spring-data-elasticsearch.version>4.4.10</spring-data-elasticsearch.version>
    <elasticsearch.version>7.17.9</elasticsearch.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework.data</groupId>
        <artifactId>spring-data-elasticsearch</artifactId>
        <version>${spring-data-elasticsearch.version}</version>
    </dependency>
    <dependency>
        <groupId>org.elasticsearch.client</groupId>
        <artifactId>elasticsearch-rest-high-level-client</artifactId>
        <version>${elasticsearch.version}</version>
    </dependency>
</dependencies>

注意：Spring Data Elasticsearch和Elasticsearch版本是绑定的，比如4.x对应7.x，5.x对应8.x，别乱搭配。

方法3：直接用原生JSON查询（临时救急） #

要是不想改API写法，直接把查询JSON封装成StringQuery执行，绕开类型问题：

String queryJson = """
{
  "bool": {
    "must": [
      {"term": {"winlog.event_data.TargetUserName": "USER001"}}
    ],
    "should": [
      {"term": {"winlog.event_data.Status": "0x18"}},
      {"term": {"winlog.event_data.Status": "0xC000006A"}}
    ],
    "minimum_should_match": 1
  }
}
""";

StringQuery stringQuery = new StringQuery(queryJson);
SearchHits<YourEntity> hits = elasticsearchOperations.search(stringQuery, YourEntity.class);

额外提醒 #

• 检查你的实体类中，winlog.event_data.Status和winlog.event_data.TargetUserName的字段映射是否正确，别因为类型不匹配查不到数据。
• 如果用的是Spring Data Elasticsearch 5.x及以上版本，NativeSearchQuery已经过时，建议换成SearchQuery或者直接用新版的ElasticsearchClient编写查询。

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