适用版本： 6.8-7.4
1. 错误异常的基本描述 #
Elasticsearch 在处理折叠字段时，如果找不到对应映射，会直接报错：
no mapping found for `field` in order to collapse on
这类错误常见于字段名写错、索引模板变更后字段消失，或跨索引查询时某些索引没有该字段。
2. 为什么会发生这个错误 #
collapse 必须建立在明确的字段映射之上。源码在真正检查字段类型之前，会先执行 fieldMapper(field)。如果返回 null，就直接抛出这个异常。
也就是说，这里的问题甚至早于“字段类型是否支持”“是否有 doc_values”，而是字段根本不存在。
3. 如何排查和解决这个异常 #
- 核对
collapse.field的拼写。 - 查看目标索引或别名下各索引的 mapping，确认字段是否都存在。
- 如果是跨索引搜索，检查是否有索引缺少该字段。
典型易错点包括：
userId写成userid- 把
title.keyword写成title_keywrod - 搜索别名覆盖多个索引，但只有部分索引有该字段
4. 如何解决这个错误 #
方案一：修正字段名 #
最直接的修复方式是把 collapse.field 改为真实存在的字段。
方案二：统一索引 mapping #
如果是别名跨多个索引查询，需确保这些索引在折叠字段上保持一致，否则应拆分查询范围。
方案三：重建模板或索引 #
如果字段本应存在但因为模板调整丢失，需要修复模板并重建受影响索引。
5. 预防建议 #
- 对折叠字段做统一命名和模板约束，避免不同索引结构漂移。
- 对 alias 查询做集成校验，避免只在单索引测试通过。
- 在 DSL 构建层维护可用字段清单，减少字符串硬编码。
6. 小结 #
no mapping found for ... in order to collapse on 表示 Elasticsearch 连折叠字段都找不到。处理这类问题，优先检查字段拼写、索引范围和 mapping 一致性，而不是去调优查询参数。
相关错误 #
- unknown-type-for-collapse-field-how-to-solve-this-elasticsearch-exception
- cannot-collapse-on-field-field-without-doc-values-how-to-solve-this-elasticsearch-exception
- invalid-token-in-the-inner-collapse-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
throw new SearchContextException(context; "cannot use `collapse` in conjunction with `rescore`");
} MappedFieldType fieldType = context.getQueryShardContext().fieldMapper(field);
if (fieldType == null) {
throw new SearchContextException(context; "no mapping found for `" + field + "` in order to collapse on");
}
if (fieldType instanceof KeywordFieldMapper.KeywordFieldType == false &&
fieldType instanceof NumberFieldMapper.NumberFieldType == false) {
throw new SearchContextException(context; "unknown type for collapse field `" + field +
"`; only keywords and numbers are accepted");
