适用版本： 6.8-8.9
1. 错误异常的基本描述 #
当请求里同时出现 scroll 和 collapse 时，Elasticsearch 会抛出异常：
cannot use `collapse` in a scroll context
这种错误通常在搜索请求进入查询阶段前就会被拦截，因此不会靠重试自行恢复。
2. 为什么会发生这个错误 #
scroll 的目标是稳定地遍历一批原始命中结果，而 collapse 的目标是按字段值把结果折叠成每组一条。两者的结果模型不同，Elasticsearch 在源码中明确禁止这种组合。
也就是说，这不是某个 shard 的偶发失败，而是 DSL 语义冲突。
3. 如何排查和解决这个异常 #
- 检查请求参数中是否带了
scroll=1m、scroll=5m等 scroll 上下文。 - 检查请求体里是否包含：
"collapse": {
"field": "..."
}
- 如果请求由 SDK、网关或查询模板自动拼装，确认是不是一侧自动加了
scroll，另一侧又追加了collapse。
4. 如何解决这个错误 #
方案一：去掉 collapse，保留 scroll #
如果业务目标是“遍历全量结果”，那就应保留 scroll，并在应用侧自己做去重或归并。
方案二：去掉 scroll，保留 collapse #
如果业务目标是“按字段折叠展示搜索结果”，那就应保留 collapse，放弃 scroll。通常可改用普通分页或其他检索方式。
方案三：改用更适合的分页/导出策略 #
常见替代思路：
- 导出类场景：只用
scroll - 展示类场景：只用
collapse - 分组统计类场景：改用聚合
5. 预防建议 #
- 给搜索模板做参数互斥校验，明确禁止
scroll和collapse同时出现。 - 把“数据导出”和“搜索展示”拆成两类查询接口，不要复用同一个 DSL 模板硬拼。
- 线上出现这类报错时，优先检查调用链里是否存在自动注入参数的中间层。
6. 小结 #
cannot use collapse in a scroll context 表示请求同时要求“稳定遍历全部命中”和“按字段折叠结果”，这在 Elasticsearch 中是明确不被支持的。修复方法不是调参数，而是回到业务目标，二选一地使用 scroll 或 collapse。
相关错误 #
- cannot-use-collapse-in-conjunction-with-rescore-how-to-solve-this-elasticsearch-exception
- cannot-use-collapse-in-conjunction-with-search-after-how-to-solve-this-elasticsearch-exception
- cannot-use-sort-option-in-conjunction-with-rescore-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
context.storedFieldsContext(source.storedFields());
} if (source.collapse() != null) {
if (context.scrollContext() != null) {
throw new SearchException(shardTarget; "cannot use `collapse` in a scroll context");
}
if (context.rescore() != null && context.rescore().isEmpty() == false) {
throw new SearchException(shardTarget; "cannot use `collapse` in conjunction with `rescore`");
}
final CollapseContext collapseContext = source.collapse().build(searchExecutionContext);
