Spring Data Elasticsearch 5.0+中NativeSearchQuery的替代及迁移报错问题

等效替代类 #

在Spring Data Elasticsearch 5.0及以上版本，org.springframework.data.elasticsearch.core.query.NativeSearchQuery的等效替代类是org.springframework.data.elasticsearch.client.elc.NativeQuery，对应的构建器是NativeQueryBuilder。你选的替代类本身是正确的，迁移失败是因为新旧版本API细节不兼容，需要调整代码中的构建逻辑。

代码迁移的核心问题点 #

你的迁移代码仍在使用旧Elasticsearch客户端的API（比如旧的FetchSourceFilterBuilder、QueryBuilders、FieldSortBuilder），但Spring Data Elasticsearch 5.x基于Elasticsearch Java Client（新客户端），API结构已发生变化，必须替换为新客户端对应的类。

正确的迁移代码示例 #

以下是适配Spring Data Elasticsearch 5.x的完整代码：

import org.springframework.data.elasticsearch.client.elc.NativeQuery;
import org.springframework.data.elasticsearch.client.elc.NativeQueryBuilder;
import co.elastic.clients.elasticsearch._types.SortOrder;

// 构建查询
NativeQuery query = new NativeQueryBuilder()
        // 配置源过滤（无需旧的FetchSourceFilterBuilder）
        .withSourceFilter(sourceFilter -> sourceFilter.includes())
        // 构建term查询（使用新客户端的lambda风格API）
        .withQuery(q -> q.term(t -> t.field(Configuration.CONFIGURATION_TYPE).value(field)))
        // 配置字段排序（使用新客户端的排序API）
        .withSort(sort -> sort.field(f -> f.field(Configuration.NAME).order(SortOrder.Asc)))
        .withPageable(pageable)
        .build();

关键修改说明 #

• 源过滤：不再依赖旧的FetchSourceFilterBuilder，通过NativeQueryBuilder的lambda表达式直接配置sourceFilter
• 查询构建：替换旧的org.elasticsearch.index.query.QueryBuilders为新客户端的lambda式查询构造，符合Elasticsearch Java Client的API设计
• 排序构建：替换旧的FieldSortBuilder为新客户端的排序配置方式，通过lambda定义字段排序规则

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