Java集合分组技巧：Stream.groupingBy使用详解

本文深入解析了Java中Stream.groupingBy的实战要点与常见陷阱：默认返回无序HashMap，需显式指定LinkedHashMap::new才能保持插入顺序；多字段分组推荐使用record构建不可变组合键，避免字符串拼接或可变对象带来的隐患；统计数量应直接使用counting()下游收集器，高效且节省内存；而最易被忽视的是keyMapper返回null将直接触发NPE——它不会归入特殊分组，必须通过预过滤、兜底默认值等方式主动防御。掌握这些细节，才能写出健壮、高效、可维护的分组逻辑。

groupingBy 分组结果是 HashMap 还是 LinkedHashMap？

默认情况下 Collectors.groupingBy() 返回的是 HashMap，不保证插入顺序。如果你依赖分组后的键顺序（比如按原始集合中首次出现顺序），必须显式指定下游收集器：Collectors.groupingBy(keyMapper, LinkedHashMap::new, downstream)。

常见错误现象：分组后遍历 Map，发现键的顺序和输入元素出现顺序不一致，误以为逻辑出错。

• 不指定 map 工厂时，JDK 8+ 默认用 HashMap::new，无序
• 需要有序请用 LinkedHashMap::new，但注意它不支持并发
• 若需线程安全且有序，得换方案（如先分组再排序，或用 ConcurrentSkipListMap 配合自定义比较器）

怎么按多个字段分组？

groupingBy 本身只接受一个 Function 作为分类函数，但你可以把多个字段“合成”一个键——最常用的是构造一个不可变的组合对象或用 AbstractMap.SimpleImmutableEntry，更轻量的是拼接字符串（仅限简单场景）。

使用场景：订单列表按 status 和 region 联合分组。

• 推荐方式：用 record（JDK 14+）或自定义不可变类，例如 record StatusRegion(String status, String region) {}，然后 groupingBy(o -> new StatusRegion(o.getStatus(), o.getRegion()))
• 避免用字符串拼接（如 o.getStatus() + "|" + o.getRegion()），一旦字段含 | 就崩
• 不要在 key 中放可变对象（如普通 ArrayList），会导致哈希码变化、查找失败

分组后想统计数量而不是收集元素，该用哪个重载？

别写 groupingBy(keyMapper, counting()) ——这会返回 Map，但很多人误以为要手动调 list.size()。其实 counting() 就是为此设计的下游收集器，性能比 mapping(..., toList()) + size() 好得多。

性能影响：对百万级数据，counting() 是单次遍历 O(n)，而先收集再取 size 是 O(n) + 内存开销，还可能触发 GC。

• 正确写法：Map countByType = list.stream().collect(Collectors.groupingBy(Item::getType, Collectors.counting()));
• 错误写法：groupingBy(Item::getType, mapping(Function.identity(), toList())) 然后循环取 .size()，纯属浪费内存和 CPU
• 如果还要同时做其他聚合（如求和、平均值），直接换用 summarizingInt 或 teeing（JDK 12+）

空指针异常（NullPointerException）从哪来？

最常发生在分类函数返回 null 时：groupingBy(obj -> obj.getCategory())，而某个 obj 的 getCategory() 返回 null。此时 Collectors.groupingBy 会直接抛 NullPointerException，不是 NullPointerException 在你代码里，而是在 Collector 内部。

容易踩的坑：以为 null 值会被归到一个叫 "null" 的组里，实际不会——它根本过不了哈希计算那关。

• 修复方法一：提前过滤，stream.filter(Objects::nonNull).filter(o -> o.getCategory() != null)
• 修复方法二：在 keyMapper 中兜底，o -> Optional.ofNullable(o.getCategory()).orElse("UNKNOWN")
• 修复方法三：用 groupingByConcurrent 不会改善这点，null 问题一样存在

真正复杂的地方在于：这个 null 可能来自嵌套调用（比如 user.getAddress().getCity()），堆栈信息不直观，得一层层查源头。别急着加 try-catch，先确认 key 函数是否可能返回 null。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java集合分组技巧：Stream.groupingBy使用详解》文章吧，也可关注golang学习网公众号了解相关技术文章。