Spring Data Elasticsearch字符串列表in查询无结果，整数类型正常

现象回顾 #

实体类定义中label和catNumber都标记为FieldType.Keyword类型：

public class MyDocument {
    @Id
    private String code;
    @Field(type = FieldType.Keyword)
    private String label;
    @Field(type = FieldType.Keyword)
    private Integer catNumber;
    ...
}

使用is查询label能正常返回结果，但用in查询包含该值的列表时无结果，而catNumber的in查询完全正常。

可能原因及解决方法 #

1. 检查实际生成的查询DSL #

Spring Data Elasticsearch的Criteria.in()和Criteria.is()生成的查询语句可能存在差异，你可以开启日志查看实际发送给Elasticsearch的请求：
在配置文件中添加日志配置：

logging.level.org.springframework.data.elasticsearch.client.WIRE=TRACE

对比两种查询的DSL，确认字段名、参数是否正确（比如is生成term查询，in生成terms查询）。

2. 手动替换为原生TermsQuery #

如果Criteria.in()存在处理字符串列表的问题，直接使用Elasticsearch原生查询构建器：

var labels = List.of("label1", "label2");
Criteria criteria = new Criteria();

if (null != labels && !labels.isEmpty()) {
    // 手动构建terms查询
    Query termQuery = QueryBuilders.termsQuery("label", labels);
    criteria.and(termQuery);
}

// 后续查询逻辑不变
var query = new CriteriaQuery(criteria);
query.setPageable(pageable);
var result = template.search(query, InstallatieDocument.class, IndexCoordinates.of("mydocument"));

3. 确认索引映射与数据一致性 #

• 检查索引的实际映射，确认label字段确实是keyword类型：
  用curl或Kibana执行：

GET /mydocument/_mapping

如果映射中label是text类型（可能自动映射导致），terms查询会无法命中，但你的is查询能正常返回，这个概率较低，但仍需确认。

• 检查labels列表中的字符串是否存在空格、隐藏特殊字符：比如列表中的字符串带前后空格，但索引中存储的是无空格的有效值，此时in查询会匹配失败。

4. 版本兼容问题排查 #

部分旧版本的Spring Data Elasticsearch在处理字符串类型的in查询时存在bug，尝试升级到对应Spring Boot版本兼容的最新稳定版（比如Spring Boot 2.x升级到2.7.x系列最新版，Spring Boot 3.x升级到3.x系列最新版）。

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