选择 from/size 还是 scroll,先看两个条件:分页是否要“跳到第 N 页”、以及这次查询是给用户实时看还是做一次性批量取数。浅层交互式翻页用 from/size 最直接,写起来简单、能随意跳页;深翻页或全量导出用 scroll 更稳,但 scroll 拿到的是一份快照,不能当作实时翻页接口用。如果只是翻到几十页,硬上 scroll 只会多出上下文管理成本;如果是导出几十万条,用 from/size 不断地加大 from,排序和窗口开销通常会让查询变慢,还容易撞上窗口上限。
判断顺序建议是:先算最大翻页深度和单次要取的数据量;深度在窗口限制内且需要跳页,用 from/size;需要顺序翻到底或全量导出,用 scroll,并设置合理的有效期、分批处理、用完显式清理。scroll 返回的是发起时的快照,不包含后续写入;窗口上限和快照资源占用这两点要先在自己的索引和集群上确认,再决定是否调整。
先确认当前场景和目标
动手写查询前,先把几件事确认清楚,否则选型容易反复:
- 翻页深度:最大 from+size 是多少。Elasticsearch 索引有 index.max_result_window 限制,默认值通常是 10000,超过会直接报错。先确认目标索引当前的实际设置,不要假设。
- 是否跳页:用户点“下一页/上一页”或直接输入页码,需要随机访问;scroll 只能顺序往下取。
- 数据一致性:scroll 是查询发起时的快照,如果导出过程中数据仍在写入,scroll 不会包含新数据。这一点对账、导出类任务要先跟业务确认能否接受。
- 返回字段量:只取需要的字段(_source 过滤),大批量拉全字段会放大网络和内存开销。
- 集群资源:scroll 上下文会在集群里占用资源直到过期或被清理,导出任务多的时候要评估并发数量。
按这个顺序处理
先确认窗口上限,再按用途分流:
# 查看索引的分页窗口设置
GET /orders/_settings?include_defaults=true如果最大深度在窗口范围内,且需要跳页,用 from/size,并带上确定的排序字段,避免同分时顺序不稳定导致翻页重复或漏数据:
GET /orders/_search
{
"from": 40,
"size": 20,
"sort": [{"created_at": "desc"}, {"order_id": "asc"}],
"query": {"term": {"status": "paid"}},
"_source": ["order_id", "status", "created_at"]
}如果是要顺序翻到底或全量导出,用 scroll:第一批带上查询和有效期,后续只用 scroll_id 取下一批,取完主动清理。
POST /orders/_search?scroll=2m
{
"size": 1000,
"sort": ["_doc"],
"query": {"term": {"status": "paid"}},
"_source": ["order_id", "created_at"]
}
POST /_search/scroll
{
"scroll": "2m",
"scroll_id": "<上一步返回的 scroll_id>"
}
DELETE /_search/scroll
{
"scroll_id": ["<scroll_id>"]
}如果既要深翻页又要相对新鲜的顺序遍历,且集群版本支持 point-in-time,可以先开 PIT,再用 search_after 按唯一排序字段往后取。这一点需要结合自己的版本确认,不同版本的接口形态不一致,不要照搬别处的请求体。

不建议用“把 max_result_window 调大”作为深翻页的常规方案。窗口调大后,每次查询要维护的候选集更大,排序和堆内存开销随之上升,属于临时放行而不是解决办法;确实要调,也要先确认业务是否真的需要跳到那么深的页码。
改完后怎么验证
验证不用只看请求有没有返回 200,按下面几项对照:
- 翻页完整性:记录每页返回的主键集合,检查是否有重复或断档;from/size 在排序字段有重复值时尤其容易出现这个问题。
- 总数口径:看 hits.total 的 relation 是精确值还是 “gte”,如果是后者,说明总数是下限,别直接拿来做对账总量。
- scroll 批次:统计最后一批返回的条数是否小于 size,这是结束的常见信号;同时确认 scroll_id 用过之后已经清理。
- 资源信号:观察搜索线程池是否有 rejected、节点堆内存和 GC 是否有明显变化,导出任务与线上查询是否互相挤压。
- 数据时效:如果是导出,抽样比对快照开始之后新写入的文档是否不在结果里,确认业务能接受这个边界。
容易忽略的边界
scroll 的有效期是“两次请求之间的空闲时间”,不是整个任务的总时长;批次处理慢、中间有停顿,就可能在中途拿到上下文已过期的错误,需要按任务时长设置并留余量。scroll 上下文不清理会一直占资源,异常退出时也要兜底清理。
from+size 在深页码下会先取出 from+size 条再丢弃前 from 条,页码越深,单次请求的成本越高;这不是靠加机器就能无感消化的。涉及排序字段有大量相同值时,需要补一个唯一字段做次级排序,否则翻页顺序不稳定。
另外,scroll 不反映查询发起之后的写入和删除,不能当成实时列表接口;如果业务需要实时性,回退到浅层 from/size 或者带游标条件(如按时间范围、主键范围)的查询更合适。调整窗口设置或改用 PIT 之前,先确认集群版本、索引模板是否会覆盖该设置、以及账号是否有修改索引设置的权限,拿不准就在测试索引上先跑一遍。