适用版本： 6.8-7.4
1. 错误异常的基本描述 #
使用字段折叠时，如果还配置了 inner_hits，但折叠字段本身不可索引，查询会报错：
cannot expand `inner_hits` for collapse field `field`; only indexed field can retrieve `inner_hits`
这意味着折叠本身可能能通过，但一旦要求返回每组的 inner_hits，Elasticsearch 发现该字段没有索引能力，就无法继续。
2. 为什么会发生这个错误 #
collapse 和 inner_hits 对字段的要求并不完全相同：
collapse依赖doc_valuesinner_hits还要求字段是可索引的
源码里对应的判断是：当 fieldType.indexOptions() == IndexOptions.NONE 且 inner_hits 非空时，直接抛错。
因此，常见触发场景是：
- 字段关闭了
index - 字段只保留了
doc_values以供排序/聚合，但没有建立倒排索引 - 映射设计本来只想用于聚合，后来又把它拿来做
collapse + inner_hits
3. 如何排查和解决这个异常 #
- 检查请求里是否同时用了
collapse和inner_hits。 - 查看折叠字段的 mapping，确认是否设置了
"index": false。 - 确认业务目标是不是一定需要
inner_hits。
典型请求形态如下：
"collapse": {
"field": "user_id",
"inner_hits": {
"name": "latest_docs",
"size": 3
}
}
如果 user_id 映射类似下面这样，就会触发异常：
"user_id": {
"type": "keyword",
"index": false
}
4. 如何解决这个错误 #
方案一：启用字段索引能力 #
如果业务必须使用 inner_hits，就要保证折叠字段是已索引字段。对于新索引，可将映射调整为：
"user_id": {
"type": "keyword",
"index": true,
"doc_values": true
}
如果是已有索引，通常需要重建索引。
方案二：移除 inner_hits #
如果只想按字段折叠返回一条代表文档，不需要每组展开更多命中，可以保留 collapse，删掉 inner_hits。
方案三：改用其他实现方式 #
如果字段天然不适合建立索引，可以考虑：
- 用聚合代替
collapse + inner_hits - 在应用端根据返回结果自行补查明细
- 调整文档结构，专门保留可索引且可折叠的字段
5. 预防建议 #
- 在设计 mapping 时，把“只用于聚合/排序”的字段和“还要参与搜索/展开”的字段区分清楚。
- 对
collapse + inner_hits场景，至少提前验证两个条件：doc_values和index。 - 不要等到查询上线后才依赖异常信息倒推字段能力。
6. 小结 #
cannot expand inner_hits for collapse field 的本质是：折叠字段虽然能参与分组，但没有索引能力，无法支撑 inner_hits 的展开。修复方式也很明确，要么让字段可索引，要么取消 inner_hits，避免让 DSL 超出字段本身的能力边界。
相关错误 #
- cannot-collapse-on-field-field-without-doc-values-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-rescore-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
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`");
} return new CollapseContext(field; fieldType; innerHits);
}
