适用版本： 8.4-8.9
1. 错误异常的基本描述 #
Unknown map reducer [mapReducerName] 表示节点在反序列化聚合结果时，读到了一个自己不认识的 map reducer 名称，因此无法继续还原 frequent_item_sets 相关聚合结果。
这不是普通 DSL 拼写错误。根据当前页面保留的源码，它发生在内部聚合结果从流中读取的阶段，说明 写出结果的节点和读取结果的节点，对 map reducer 的实现或名称认知不一致。
典型报错 #
AggregationExecutionException: Unknown map reducer [foo]
2. 为什么会发生这个错误 #
- 集群中节点版本不一致，部分节点支持新的 reducer，部分节点还不支持。
- 插件或特性模块不一致，某些节点缺少对应实现。
- 序列化数据损坏，导致读取到异常 reducer 名称。
- 在升级、回滚或灰度过程中，聚合结果在不同版本节点间传递。
3. 排查步骤 #
- 确认报错发生时集群是否存在混合版本节点。
- 检查所有节点安装的插件、模块和发行版是否一致。
- 查看异常是否只在某类聚合请求上出现，尤其是
frequent_item_sets或相关实验性能力。 - 如果是在升级后出现，核对请求是否被路由到新旧节点混合的集群中。
4. 修复建议 #
方案一：统一节点版本和模块 #
确保所有参与查询与归并的节点使用一致的 Elasticsearch 版本与插件组合，这是最常见、也最直接的修复方式。
方案二：避免跨版本混跑该聚合 #
如果正在滚动升级，暂时停止使用依赖该 reducer 的聚合，等集群全部升级完成后再恢复。
方案三：检查损坏或脏数据 #
如果版本和模块完全一致，仍持续报同一个 reducer 名称异常，需要进一步排查节点间传输数据或序列化内容是否异常。
5. 小结 #
Unknown map reducer [mapReducerName] 反映的不是请求 JSON 语法问题，而是 内部聚合结果的序列化/反序列化协议不一致。优先检查版本、插件和滚动升级状态，通常比盲目修改 DSL 更有效。
相关错误 #
- registry-miss-match-expected-termsaggregatorsupplier-found-how-to-solve-this-elasticsearch-exception
- unregistered-aggregation-aggregationname-how-to-solve-this-elasticsearch-exception
- unsupported-aggregation-type-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
return (in -> new InternalItemSetMapReduceAggregation<>(in; (mapReducerReader) -> {
String mapReducerName = in.readString();
if (EclatMapReducer.NAME.equals(mapReducerName)) {
return new EclatMapReducer(FrequentItemSetsAggregationBuilder.NAME; in);
}
throw new AggregationExecutionException("Unknown map reducer [" + mapReducerName + "]");
}));
} private final Listfields;
private final double minimumSupport;
