适用版本： 6.8-8.9
1. 错误异常的基本描述 #
当 rescore 配置中出现不被支持的字段名时，解析器会抛出：
rescore doesn't support [fieldName]
2. 为什么会发生这个错误 #
这个错误不是字段 mapping 不支持，而是 rescore 配置对象里出现了非法字段。源码在解析 rescore 顶层时，只接受少量固定字段，例如 window_size 以及具体的 rescorer 对象。如果遇到其他 value 字段，就会直接抛 ParsingException。
换句话说，这是 DSL 结构错误，不是索引字段能力问题。
3. 如何排查和解决这个异常 #
- 检查
rescore顶层是否写入了未支持的属性。 - 注意区分“rescore 顶层字段”和“query rescorer 内部字段”，不要写错层级。
- 输出最终请求 JSON，避免模板把额外字段拼进
rescore对象。
4. 如何解决这个错误 #
方案一：移除非法字段 #
只保留 Elasticsearch 支持的 rescore 顶层参数。
方案二：把字段移到正确层级 #
有些字段不是完全不支持，而是应该放到 query rescorer 内部，而不是 rescore 顶层。
方案三：从最小示例重建 rescore #
如果 DSL 已经比较复杂，建议从最小可用 rescore 示例重新构建，再逐步恢复参数。
5. 预防建议 #
- 不要手写自由扩展的
rescoreJSON；应使用结构化 builder。 - 给查询模板加 schema 校验，避免未识别字段进入
rescore。 - 对复杂 DSL 做序列化后校验，确保最终 JSON 符合 Elasticsearch 预期。
6. 小结 #
rescore doesn't support [fieldName] 表示 rescore 对象里出现了未被接受的字段。修复重点是调整 DSL 结构和层级，而不是去排查 mapping 或资源状态。
相关错误 #
- missing-rescore-type-how-to-solve-this-elasticsearch-exception
- rescore-window-rescorecontext-getwindowsize-is-too-large-how-to-solve-this-elasticsearch-exception
- rescore-phase-failed-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
fieldName = parser.currentName();
} else if (token.isValue()) {
if (WINDOW_SIZE_FIELD.match(fieldName; parser.getDeprecationHandler())) {
windowSize = parser.intValue();
} else {
throw new ParsingException(parser.getTokenLocation(); "rescore doesn't support [" + fieldName + "]");
}
} else if (token == XContentParser.Token.START_OBJECT) {
rescorer = parser.namedObject(RescorerBuilder.class; fieldName; null);
} else {
throw new ParsingException(parser.getTokenLocation(); "unexpected token [" + token + "] after [" + fieldName + "]");
