适用版本： 6.8-6.8
1. 错误异常的基本描述 #
如果 rescore.window_size 设置过大，会看到报错：
Rescore window [N] is too large. It must be less than [maxWindow].
2. 为什么会发生这个错误 #
rescore 只会对顶部若干命中做再次打分。窗口越大，需要暂存和重排的结果越多，内存消耗也越高。为了防止单个查询分配过大的堆内存，Elasticsearch 用索引级设置 max_rescore_window 做硬限制。
当 rescoreContext.getWindowSize() > maxWindow 时，请求会被直接拒绝。
3. 如何排查和解决这个异常 #
- 查看请求里的
window_size。 - 查看索引设置中的最大
rescore窗口。 - 评估该窗口是否真的有必要，还是调用方盲目放大了精排范围。
4. 如何解决这个错误 #
方案一：降低 window_size #
这是最稳妥的处理方式。大多数精排场景并不需要对非常大的候选集做二次打分。
方案二：调整索引级上限 #
如果确有业务需要，可以评估内存成本后，适当调大相关索引设置。但这不是默认推荐路径。
方案三：优化召回阶段 #
如果必须扩大精排范围，说明第一阶段召回不够精确。可以考虑优化 query，减少进入 rescore 的候选数量。
5. 预防建议 #
- 对
window_size设上限，不要由调用方自由传极大值。 - 压测精排请求，确认扩大窗口带来的收益是否值得额外资源成本。
- 把
max_rescore_window视为保护阈值，而不是默认要突破的目标。
6. 小结 #
Rescore window ... is too large 反映的是资源保护机制生效。修复重点通常是缩小精排窗口或优化召回，而不是一味调大上限。
相关错误 #
- cannot-use-sort-option-in-conjunction-with-rescore-how-to-solve-this-elasticsearch-exception
- missing-rescore-type-how-to-solve-this-elasticsearch-exception
- rescore-phase-failed-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
throw new QueryPhaseExecutionException(this; "Cannot use [sort] option in conjunction with [rescore].");
}
int maxWindow = indexService.getIndexSettings().getMaxRescoreWindow();
for (RescoreContext rescoreContext: rescore) {
if (rescoreContext.getWindowSize() > maxWindow) {
throw new QueryPhaseExecutionException(this; "Rescore window [" + rescoreContext.getWindowSize() + "] is too large. "
+ "It must be less than [" + maxWindow + "]. This prevents allocating massive heaps for storing the results "
+ "to be rescored. This limit can be set by changing the [" + IndexSettings.MAX_RESCORE_WINDOW_SETTING.getKey()
+ "] index level setting."); }
