search_after 不能用于 scroll 上下文 - 如何解决此 Elasticsearch 异常

适用版本： 6.8-8.9

1. 错误异常的基本描述 #

当搜索请求同时使用 search_after 和 scroll 时，Elasticsearch 会报：

`search_after` cannot be used in a scroll context.

这种错误会在请求进入查询上下文时直接被拒绝。

2. 为什么会发生这个错误 #

scroll 和 search_after 都是处理大结果集的机制，但工作方式不同：

• scroll 依赖服务器端维护滚动上下文
• search_after 依赖客户端根据上一页排序值继续请求

两者不能叠加，因此源码里只要发现 context.scrollContext() != null 且存在 search_after，就立即抛错。

3. 如何排查和解决这个异常 #

1. 检查 URL 参数或请求选项里是否带了 scroll=...。
2. 检查请求体里是否带了 search_after。
3. 确认是否有某一层中间件自动加了 scroll，而业务代码又手工追加了 search_after。

4. 如何解决这个错误 #

方案一：做全量遍历时只用 scroll #

如果目标是批量导出或全量扫描，就保留 scroll，不要使用 search_after。

方案二：做深分页时只用 search_after #

如果目标是稳定翻页，尤其是面向用户展示的分页接口，就保留 search_after，移除 scroll。

方案三：拆分接口职责 #

不要试图让同一套查询模板同时服务“导出”和“分页展示”两类场景。

5. 预防建议 #

• 在查询构建层增加互斥校验，发现 search_after 与 scroll 同时存在时直接拦截。
• 对分页模板做回归测试，覆盖 URL 参数和请求体两侧的组合情况。
• 统一团队约定，明确不同业务场景使用哪一种深分页方案。

6. 小结 #

search_after cannot be used in a scroll context 的含义很明确：两种分页机制被混用了。修复时只需要根据业务目标二选一，而不是尝试继续兼容这两套模型。

相关错误 #

• from-parameter-must-be-set-to-0-when-search-after-is-used-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 (source.stats() != null) {
 context.groupStats(source.stats());
}
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.");
 }