适用版本： 6.8-7.13
1. 错误异常的基本描述 #
当搜索请求同时包含 collapse 和 search_after，会看到类似错误：
cannot use `collapse` in conjunction with `search_after`
这种错误一般会在查询上下文构建阶段被直接拒绝。
2. 为什么会发生这个错误 #
search_after 用于基于稳定排序值继续翻页，要求结果顺序可持续、可追踪；collapse 则会把多条命中折叠成每组一条。折叠后结果集已不再是普通排序命中的连续切片，因此 Elasticsearch 在该版本中不允许两者一起使用。
这说明问题出在查询模型设计，而不是分片状态或节点负载。
3. 如何排查和解决这个异常 #
- 查看请求体中是否同时出现：
"collapse": { "field": "..." }
和：
"search_after": [ ... ]
- 检查该请求是否由“列表翻页模板”追加了
search_after，同时又由“结果去重模板”追加了collapse。 - 明确这次查询是要“稳定深分页”，还是要“按字段折叠展示”。
4. 如何解决这个错误 #
方案一：保留 search_after，移除 collapse #
如果业务要稳定深分页，尤其是大结果集翻页，应保留 search_after，不要做折叠。
方案二：保留 collapse，改回普通分页或其他方式 #
如果业务重点是去重展示，可以保留 collapse，改用更简单的翻页方式，或者在应用端处理翻页逻辑。
方案三：拆成两个查询流程 #
对于同时有“去重展示”和“深分页”诉求的场景，通常要拆分：
- 一个接口负责精确分页
- 一个接口负责折叠展示
不要把两种语义硬塞进同一条 DSL。
5. 预防建议 #
- 给查询构建器增加互斥规则，禁止
collapse和search_after同时出现。 - 在 API 设计上明确区分“翻页接口”和“去重接口”。
- 对分页查询进行集成测试时，把自动追加的
sort、search_after、collapse一起验证。
6. 小结 #
cannot use collapse in conjunction with search_after 反映的是分页模型与折叠模型冲突。修复时不要围绕异常做表面兼容，而应先确定业务到底需要哪种结果语义，再选择 search_after 或 collapse。
相关错误 #
- cannot-use-collapse-in-a-scroll-context-how-to-solve-this-elasticsearch-exception
- cannot-use-collapse-in-conjunction-with-rescore-how-to-solve-this-elasticsearch-exception
- cannot-use-sort-option-in-conjunction-with-rescore-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
if (source.collapse() != null) {
if (context.scrollContext() != null) {
throw new SearchException(shardTarget; "cannot use `collapse` in a scroll context");
}
if (context.searchAfter() != null) {
throw new SearchException(shardTarget; "cannot use `collapse` in conjunction with `search_after`");
}
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);
