适用版本： 6.8-7.4
1. 错误异常的基本描述 #
当搜索请求里使用了 collapse，但目标字段没有 doc_values 时，Elasticsearch 会抛出类似下面的异常：
cannot collapse on field `field` without `doc_values`
这类错误通常出现在查询阶段，请求会直接失败，常见返回码是 400。
2. 为什么会发生这个错误 #
字段折叠依赖 doc_values 来按字段值做高效分组与去重。如果字段映射里关闭了 doc_values，或者字段类型本身不适合用于折叠，collapse 就无法执行。
从源码逻辑看，Elasticsearch 会先校验字段类型，再校验是否启用了 doc_values：
- 只接受适合折叠的字段类型，典型是
keyword和数值类型 - 如果
fieldType.hasDocValues() == false，直接抛出异常
因此这不是运行时资源不足，也不是偶发问题，而是查询条件和字段映射不匹配。
3. 如何排查和解决这个异常 #
- 检查请求中
collapse.field指向的是哪个字段。 - 查看该字段的 mapping，确认是否启用了
doc_values。 - 确认字段类型是否适合折叠，避免把
text字段直接用于collapse。
可先执行类似查询确认映射：
GET index_name/_mapping
重点关注：
- 字段是否为
keyword、整数、长整型等可折叠类型 - 是否显式设置了
"doc_values": false - 是否误把
text主字段拿来折叠，而不是它的.keyword子字段
4. 如何解决这个错误 #
方案一：改用支持 doc_values 的字段
#
最常见的修复方式是把：
"collapse": {
"field": "title"
}
改为：
"collapse": {
"field": "title.keyword"
}
前提是 title.keyword 已建立且保留了 doc_values。
方案二：调整 mapping 后重建索引 #
如果当前字段必须承担折叠用途，就需要在 mapping 中启用 doc_values，然后重建索引。Elasticsearch 不能直接对已有字段原地修改这类底层结构。
示例：
"user_id": {
"type": "keyword",
"doc_values": true
}
方案三：避免在不适合的字段上使用 collapse #
如果字段是全文检索字段、分析字段，或者业务上只是想“展示一条代表结果”，也可以考虑：
- 改用聚合实现分组
- 在应用层做去重
- 重新设计索引结构，专门保留一个可折叠字段
5. 预防建议 #
- 设计 mapping 时，提前区分“全文检索字段”和“排序/聚合/折叠字段”。
- 对需要
sort、terms aggregation、collapse的字段，优先使用keyword或数值类型。 - 在上线新查询前，用真实 mapping 做一次 DSL 校验，避免把
text字段直接用于折叠。
6. 小结 #
cannot collapse on field ... without doc_values 的含义很直接：折叠字段缺少 doc_values 支持。修复重点不在查询重试，而在于校正字段选择或调整 mapping。只要保证 collapse 使用的是启用了 doc_values 的合适字段，这类错误就能稳定消除。
相关错误 #
- cannot-expand-inner-hits-for-collapse-field-how-to-solve-this-elasticsearch-exception
- cannot-use-collapse-in-a-scroll-context-how-to-solve-this-elasticsearch-exception
- cannot-use-collapse-in-conjunction-with-search-after-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
throw new SearchContextException(context; "unknown type for collapse field `" + field +
"`; only keywords and numbers are accepted");
} if (fieldType.hasDocValues() == false) {
throw new SearchContextException(context; "cannot collapse on field `" + field + "` without `doc_values`");
}
if (fieldType.indexOptions() == IndexOptions.NONE && (innerHits != null && !innerHits.isEmpty())) {
throw new SearchContextException(context; "cannot expand `inner_hits` for collapse field `"
+ field + "`; " + "only indexed field can retrieve `inner_hits`");
}
