如何通过Spring Data Elasticsearch对新增字段进行排序？

核心问题原因 #

你遇到的报错是因为旧索引里没有date字段的映射定义，Spring Data Elasticsearch默认的Repository方法生成的排序查询不会自动添加ignore_unmapped参数，导致ES找不到该字段映射而报错。下面提供几种可行的解决办法：

方法一：先更新索引映射（最根本的解决方式） #

首先要确保Elasticsearch的索引里存在date字段的映射定义，后续查询才能正常识别该字段。可以通过Spring Data Elasticsearch的ElasticsearchOperations来更新映射：

@Autowired
private ElasticsearchOperations elasticsearchOperations;

public void updateIndexMapping() {
    // 根据实体类注解生成并更新索引映射
    elasticsearchOperations.putMapping(MyEntity.class);
}

执行这个方法后，ES索引会新增date字段的映射。已有的旧文档不会自动填充date字段，但查询时会将无该字段的文档视为null，排序时默认排到末尾（升序）或开头（降序）。

方法二：手动构建查询并设置 ignore_unmapped #

如果不想先更新映射，或者需要临时处理，可以用ElasticsearchOperations手动构建查询，在排序规则里添加ignore_unmapped参数：

@Autowired
private ElasticsearchOperations elasticsearchOperations;

public List<MyEntity> findAllSortedByDate() {
    // 构建排序规则，开启ignore_unmapped
    Sort sort = Sort.by(
        Sort.Order.asc("date")
            .withUnmappedType(FieldType.Date)
            .ignoreUnmapped(true)
    );

    NativeSearchQuery query = new NativeSearchQueryBuilder()
        .withSort(sort)
        .build();

    SearchHits<MyEntity> searchHits = elasticsearchOperations.search(query, MyEntity.class);
    return searchHits.stream()
        .map(SearchHit::getContent)
        .collect(Collectors.toList());
}

这种方式不需要修改索引映射，查询时ES会忽略无date字段文档的排序错误，将它们视为null参与排序。

方法三：自定义Repository方法，用注解开启 ignore_unmapped #

在Repository接口里自定义方法，通过@SortDefault注解直接开启忽略未映射字段的功能：

public interface MyEntityRepository extends ElasticsearchRepository<MyEntity, String> {

    @SortDefault(sort = "date", direction = Sort.Direction.ASC, ignoreUnmapped = true)
    List<MyEntity> findAllByOrderByDateIgnoringUnmapped();
}

这个注解会让生成的查询自动带上"ignore_unmapped": true的排序参数，避免报错。

方法四：脚本排序自定义无字段文档的排序逻辑 #

如果需要更灵活的排序规则（比如把没有date的文档固定排到最后），可以用脚本排序：

public List<MyEntity> findAllSortedByDateWithScript() {
    ScriptSortBuilder scriptSort = new ScriptSortBuilder(
        new Script("doc['date'].size() == 0 ? '9999-12-31' : doc['date'].value"),
        ScriptSortBuilder.ScriptSortType.STRING
    ).order(SortOrder.ASC);

    NativeSearchQuery query = new NativeSearchQueryBuilder()
        .withSort(scriptSort)
        .build();

    SearchHits<MyEntity> searchHits = elasticsearchOperations.search(query, MyEntity.class);
    return searchHits.stream()
        .map(SearchHit::getContent)
        .collect(Collectors.toList());
}

这个脚本会把无date字段的文档排序值设为9999-12-31，升序时它们会排在最后。

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