Kibana可执行的ES查询在Spring StringQuery中返回空结果问题

核心现象 #

用代码构建的bool filter查询字符串，在Kibana中添加外层query包裹后能正常返回3条Product数据，但通过Spring的StringQuery执行时，返回空的products列表和0页数据。

排查方向与解决办法 #

1. 去掉冗余的外层query包裹 #

Spring Data Elasticsearch的StringQuery直接接收查询体的核心内容，不需要额外套一层query节点。而Kibana中运行时需要完整的请求结构才会生效，这是两者的核心差异：

• Kibana中正确的请求结构（带外层query）：

{
  "query": {
    "bool": {
      "filter": [
        // 你的过滤条件集合
      ]
    }
  }
}

• Spring中使用StringQuery时，只需要传入内层的bool部分：

// 正确的查询字符串，不需要外层query
String queryContent = "{\"bool\":{\"filter\":[/* 你的过滤条件 */]}}";
StringQuery query = new StringQuery(queryContent);

2. 校验实体类与索引映射一致性 #

检查Product实体类的注解配置是否和Elasticsearch索引的映射完全匹配：

• 确认@Document(indexName = "你的索引名")中的索引名是否正确
• 字段的@Field注解的type、format等属性要和索引映射一致，比如日期字段的格式、文本字段的分词设置
• 避免实体类字段名和索引字段名存在大小写或命名差异（比如实体类用productName，索引里是product_name，没配置name属性的话会匹配失败）

3. 检查分页参数是否合理 #

如果用了分页查询，注意Spring Data的分页是从0开始计数：

• 若设置PageRequest.of(1, 10)，但实际只有1页数据（共3条），会返回空结果，应该用PageRequest.of(0, 10)
• 确认size参数没有设为0，否则也会返回空

4. 排查路由或别名问题 #

如果目标索引使用了路由或别名：

• 检查Spring配置是否正确关联了别名
• 若查询需要指定路由，给StringQuery添加路由参数：

query.addRouting("目标路由值");

5. 开启日志对比请求内容 #

开启Spring Data Elasticsearch的DEBUG日志，查看实际发送给ES的请求体，和Kibana中成功的请求做对比：
在application.yml中添加：

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

通过日志里的请求内容，能快速定位和Kibana请求的差异点，找到问题根源。

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