flatmapping适用于外层集合→中间对象→内层集合→子项字段的嵌套结构，典型场景是pojo包含list、item含key1和list、subitem含key2，目标按item.key1分一级、subitem.key2分二级聚合。
Java 中 Collectors.flatMapping 的核心价值，是在多层嵌套结构中做“先展开、再分组”的聚合，避免手动构造中间对象或写多层循环。它不是为单层字段组合设计的，而是专治“一个对象里有列表，列表里还有子列表，子列表里又要按某个字段归类”这类场景。
flatMapping 适合什么嵌套结构？
典型适用结构是：外层集合 → 中间对象 → 内层集合 → 子项字段。比如：
-
Pojo包含List<item></item> -
Item包含key1和List<subitem></subitem> -
SubItem包含key2和其他属性
目标是：按 Item.key1 分第一级，再按 SubItem.key2 分第二级，得到 Map<k1 map list>>></k1> 或带统计的变体。
Java 9+ 直接用 flatMapping（推荐）
代码简洁清晰，语义明确：
Map<string map list>>> result = pojo.getItems().stream()
.collect(Collectors.groupingBy(
Item::getKey1,
Collectors.flatMapping(
item -> item.getSubItems().stream(),
Collectors.groupingBy(SubItem::getKey2)
)
));
</string>
关键点：
-
flatMapping第一个参数是函数，把每个Item映射成它的subItems流 - 第二个参数是下游收集器，负责对所有“摊平后”的
SubItem做进一步聚合 - 整个过程不创建
Entry或临时包装类，内存友好、可读性强
Java 8 兼容写法（需自定义或借力）
Java 8 没有内置 flatMapping，但有两种主流解法：
- 用
flatMap + SimpleImmutableEntry手动关联上下文：
把Item和每个SubItem组成键值对，再按Item.key1分组，再按SubItem.key2二次分组 - 自行实现轻量
flatMapping收集器（几行代码）：
复用下游收集器的accumulator，对每个元素映射出子流并逐个喂给下游
后者更干净，且可复用。例如定义静态方法后，调用方式与 Java 9 完全一致，只是类名不同。
常见误区提醒
别把 flatMapping 当作“多字段联合分组”工具。它不等价于：
-
groupingBy(compositeKey)（那是拼接 key 或用 record） -
groupingBy(x -> x.a, groupingBy(x -> x.b))（这要求 a、b 在同一对象上）
它解决的是“跨层级、跨集合”的聚合路径问题。如果第二级要按多个字段（如 subItem.type 和 subItem.status），只需把 groupingBy 换成 groupingBy(x -> new AbstractMap.SimpleImmutableEntry(x.getType(), x.getStatus())) 即可，逻辑不变。
