本文介绍如何使用java stream api和collectors对对象列表按多个字段（如name、type、subtype）分组，并进一步将同组内特定子类型（如a/b）的对象两两配对生成二维列表，适用于数据归档、报表生成等场景。
在实际开发中，我们常需将扁平的对象列表按复合键（如 name + type）聚类，再对每个类内不同子类型（如 subType = "a" 和 "b"）进行结构化配对。上述需求本质上是两级分组 + 跨子类配对（zip-like），而非简单单层分组。直接嵌套 Map<String, Map<String, Map<String, Object>>> 不仅可读性差、维护成本高，还难以实现后续的配对逻辑。
推荐采用清晰、函数式、可扩展的两步法：
✅ 第一步：按主维度分组（name + type）
使用 Collectors.groupingBy 以复合键（例如 name + "|" + type）为分组依据，将原始列表划分为若干逻辑组：
record Type1(String name, String type, String subType) {} // 示例POJO（Java 14+）
Map<String, List<Type1>> groupedByMainKey = input.stream()
.collect(Collectors.groupingBy(
t -> t.name() + "|" + t.type(),
LinkedHashMap::new, // 保持插入顺序（可选）
Collectors.toList()
));✅ 第二步：对每组内 subType="a" 和 "b" 的元素配对
遍历每个主组，分别提取 subType == "a" 和 subType == "b" 的子列表，然后“拉链式”合并（zip）——即索引对齐配对，缺失项补 null（或跳过）：
立即学习“Java免费学习笔记（深入）”；
List<Type1[]> result = new ArrayList<>();
for (List<Type1> group : groupedByMainKey.values()) {
List<Type1> listA = group.stream()
.filter(t -> "a".equals(t.subType()))
.collect(Collectors.toList());
List<Type1> listB = group.stream()
.filter(t -> "b".equals(t.subType()))
.collect(Collectors.toList());
int size = Math.max(listA.size(), listB.size());
for (int i = 0; i < size; i++) {
Type1 a = i < listA.size() ? listA.get(i) : null;
Type1 b = i < listB.size() ? listB.get(i) : null;
result.add(new Type1[]{a, b});
}
}? 关键优势： 避免深层嵌套Map，结构直观、调试友好； 利用Stream API声明式表达，逻辑解耦； 支持任意数量的 subType 值（只需扩展过滤条件与配对逻辑）； LinkedHashMap 保证分组顺序，null 容忍设计增强鲁棒性。
⚠️ 注意事项
- 若业务要求严格配对（即 a 和 b 必须成对出现），可在配对前校验 listA.size() == listB.size() 并抛出异常或日志告警；
- 对于超大数据集，可考虑使用 partitioningBy 替代两次 filter 提升性能；
- 若需支持更多 subType（如 "c"、"d"），建议封装为通用 zip(List<T>...) 工具方法。
该方案兼顾简洁性、可读性与工程实用性，是处理多级分类+跨类别关联场景的典型Java流式实践。
