Elasticsearch 查询慢，是搜索系统里非常常见的问题。很多人遇到慢查询时，第一反应是加机器、加内存、调 JVM，但真正有效的优化往往要从查询语句、Mapping 设计、分片规划和数据规模入手。
ES 的查询性能不是只由集群配置决定的。一个不合理的查询，即使放在很大的集群上，也可能很慢。一个设计良好的索引，即使机器不多，也能跑得很稳。
第一步，先打开慢查询日志。
排查慢查询不要靠感觉。ES 提供了 slowlog，可以记录慢查询、慢索引请求和耗时信息。通过 slowlog 可以知道到底是哪类查询慢，是 match 查询慢，还是聚合慢，是深分页慢，还是某些索引特别慢。
慢查询日志的价值在于把问题从"系统很慢"变成"某个索引的某类 DSL 很慢"。定位范围缩小后，优化才有方向。
第二步，检查 Mapping 是否合理。
Mapping 设计是 ES 性能的基础。很多慢查询问题，其实在建索引时就埋下了。
如果一个字段只用于精确匹配、过滤、聚合或排序，应该使用 keyword 类型，而不是 text。text 会进行分词，更适合全文检索，但不适合精确聚合和排序。
如果时间字段被存成字符串，范围查询和排序都会受到影响。应该使用 date 类型。
如果数字字段被存成 text 或 keyword，也会影响范围查询和统计计算。价格、数量、评分、状态码等字段应该使用合适的数值类型。
Mapping 一旦设计错误，后期修改成本很高，通常需要重建索引。所以在业务初期就要明确每个字段的查询方式。
第三步，过滤条件尽量放到 filter 中。
在 ES 查询里，query 更偏向相关性评分，filter 更适合精确过滤。比如状态、类型、时间范围、用户 ID、租户 ID 这类条件，通常应该放在 bool.filter 中。
filter 不参与评分，更容易被缓存，性能通常更稳定。
如果业务只是查列表、查订单、查日志，不关心相关性排序，就不要让 ES 做额外评分计算。
第四步，避免深分页。
深分页是 ES 慢查询的高发原因。很多人使用 from + size 做分页，页数越深，查询越慢。
比如 from = 100000，size = 20，ES 并不是直接跳到第 100000 条，而是需要在各个分片上取出大量数据，再合并排序，最后丢掉前面的结果。这会消耗大量 CPU 和内存。
如果只是普通翻页，可以限制最大翻页深度。如果是滚动加载或导出场景，更推荐使用 search_after 或 scroll。对于实时用户查询，search_after 更适合；对于离线批量导出，scroll 或 PIT 方案更合适。
第五步，聚合查询要控制字段和范围。
ES 的聚合能力很强，但聚合也很容易拖慢集群。尤其是在高基数字段上做 terms 聚合，比如用户 ID、订单号、手机号、设备 ID，性能压力会非常大。
聚合优化可以从几个方向入手：缩小时间范围，减少聚合字段数量，控制 size 大小，避免对高基数字段做大范围聚合，对常用统计结果做预聚合或离线计算。
如果一个报表查询每次都扫大量历史数据，再做复杂聚合，那么它更适合放到离线数仓或预计算表里，而不是每次都压给 ES 实时计算。
第六步，分片数量要合理。
分片太少，会导致单分片数据量过大，查询和恢复都变慢。分片太多，又会带来额外的调度、内存和文件句柄开销。
分片规划要结合数据量、索引生命周期、查询并发和机器规模。日志类数据通常可以按时间滚动建索引，比如按天或按月。业务搜索类索引则要根据整体数据量和增长速度规划。
如果某些分片特别大，或者查询总是集中在少数分片上，也会导致热点问题。需要结合 _cat/shards、节点负载和查询路由一起分析。
第七步，关注排序字段。
排序也是慢查询常见来源。如果按照没有 doc_values 的字段排序，或者对 text 字段排序，会非常低效。
用于排序、聚合和过滤的字段，应确保类型正确，并启用合适的 doc_values。对于常见排序字段，比如创建时间、更新时间、价格、评分，可以在索引设计阶段重点优化。
第八步，别忽略数据建模。
ES 不适合复杂关联查询。如果业务经常需要跨实体 join，可能说明数据模型不适合直接照搬关系型数据库。
更常见的做法是适度冗余，把搜索所需字段提前写入同一个文档。这样查询时就不需要跨表关联，性能会更稳定。
当然，冗余会带来数据同步问题，所以要在查询性能和写入复杂度之间做权衡。
总结一下，Elasticsearch 慢查询排查可以按这条线走：先看 slowlog 定位慢 DSL，再检查 Mapping 类型是否合理，然后优化 filter、分页、聚合、排序和分片规划。ES 很强，但它不是万能数据库。用对查询方式和数据模型，才能真正发挥它的搜索性能。
封面使用 built-in image_gen 生成，已复制到：
C:\Users\Administrator\Documents\Codex\2026-06-17\csdn\outputs\cover_spring_boot_timeout_governance.png
C:\Users\Administrator\Documents\Codex\2026-06-17\csdn\outputs\cover_elasticsearch_slow_query.png
本次封面提示词风格：现代扁平技术信息图、浅色背景、流程节点、监控与排障元素、清爽工程海报。