适用版本： 6.8-8.9
1. 错误异常的基本描述 #
当请求同时设置了 search_after 和 from > 0，Elasticsearch 会报错：
`from` parameter must be set to 0 when `search_after` is used.
2. 为什么会发生这个错误 #
search_after 本身就是一种翻页游标机制，它通过上一页最后一条命中的排序值来定位下一页。如果再同时设置 from 偏移量，就会让分页语义变得不确定，因此源码明确要求：使用 search_after 时，from 必须为 0。
3. 如何排查和解决这个异常 #
- 检查请求体中是否有
search_after。 - 检查是否还残留了默认分页参数，例如
from: 10、from: 20。 - 如果请求由分页组件自动生成，确认它是否把传统分页参数和游标分页参数同时拼了进去。
4. 如何解决这个错误 #
方案一：保留 search_after，删除 from #
这是最常见也最正确的修复方式。第一页通常使用 from: 0 或省略 from，后续页只传 search_after。
方案二：如果坚持使用 from/size，就不要用 search_after #
传统分页和游标分页应二选一。
方案三：统一分页协议 #
如果应用层同时支持多种分页方式，建议在 API 层明确区分：
- 普通分页接口：
from+size - 深分页接口：
search_after
5. 预防建议 #
- 给分页构造器增加规则校验，禁止
search_after与from > 0共存。 - 前后端接口协议中明确分页模式，避免调用方混用参数。
- 保留请求日志，方便快速发现是 SDK 默认值还是业务代码显式传参导致。
6. 小结 #
from parameter must be set to 0 when search_after is used 说明请求把两套分页语义混到了一起。修复要点很简单：用 search_after 时不要再依赖 from 偏移量。
相关错误 #
- search-after-cannot-be-used-in-a-scroll-context-how-to-solve-this-elasticsearch-exception
- cannot-use-collapse-in-conjunction-with-search-after-how-to-solve-this-elasticsearch-exception
- disabling-track-total-hits-is-not-allowed-in-a-scroll-context-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
if (CollectionUtils.isEmpty(source.searchAfter()) == false) {
if (context.scrollContext() != null) {
throw new SearchException(shardTarget; "`search_after` cannot be used in a scroll context.");
}
if (context.from() > 0) {
throw new SearchException(shardTarget; "`from` parameter must be set to 0 when `search_after` is used.");
} String collapseField = source.collapse() != null ? source.collapse().getField() : null;
FieldDoc fieldDoc = SearchAfterBuilder.buildFieldDoc(context.sort(); source.searchAfter(); collapseField);
context.searchAfter(fieldDoc);
