适用版本： 6.8-8.9
1. 错误异常的基本描述 #
当请求处于 scroll 上下文，同时又试图关闭或弱化 track_total_hits 时，Elasticsearch 会报：
disabling [track_total_hits] is not allowed in a scroll context
2. 为什么会发生这个错误 #
scroll 依赖一个稳定的结果遍历上下文。源码在处理请求时发现：
context.scrollContext() != nulltrackTotalHitsUpTo不是精确值
就会直接拒绝请求。也就是说，在 scroll 模式下，Elasticsearch 不允许为了性能关闭总命中数追踪。
3. 如何排查和解决这个异常 #
- 检查请求是否带了
scroll参数。 - 检查是否设置了：
"track_total_hits": false
或其他非精确值。
3. 如果使用了统一搜索 SDK，确认它是否默认把 track_total_hits 设成了节省资源的模式。
4. 如何解决这个错误 #
方案一：scroll 场景下移除 track_total_hits 优化 #
这是最直接的修复方式。既然要用 scroll，就接受它的结果上下文约束。
方案二：如果必须关闭 total hits 跟踪，就不要使用 scroll #
可改用普通搜索或其他分页方式，避免进入 scroll 模式。
方案三：把导出类查询和普通搜索拆开 #
scroll 更适合批量遍历；普通搜索更适合交互式查询优化。不要强行共用同一套参数模板。
5. 预防建议 #
- 给 scroll 查询做专门的参数模板，避免继承普通搜索接口里的性能优化参数。
- 在 SDK 层对
scroll + track_total_hits=false做提前校验。 - 对查询模板做场景隔离，不要让导出逻辑复用列表搜索参数。
6. 小结 #
disabling [track_total_hits] is not allowed in a scroll context 表示 scroll 查询不接受关闭总命中跟踪的优化。修复方法很明确：要么保留 scroll 并遵守它的限制，要么换掉 scroll，不要两头都想要。
相关错误 #
- search-after-cannot-be-used-in-a-scroll-context-how-to-solve-this-elasticsearch-exception
- cannot-use-collapse-in-a-scroll-context-how-to-solve-this-elasticsearch-exception
- from-parameter-must-be-set-to-0-when-search-after-is-used-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
}
context.trackScores(source.trackScores());
if (source.trackTotalHitsUpTo() != null
&& source.trackTotalHitsUpTo() != SearchContext.TRACK_TOTAL_HITS_ACCURATE
&& context.scrollContext() != null) {
throw new SearchException(shardTarget, "disabling [track_total_hits] is not allowed in a scroll context");
}
if (source.trackTotalHitsUpTo() != null) {
context.trackTotalHitsUpTo(source.trackTotalHitsUpTo());
}
if (source.minScore() != null) {
