默认返回hashmap,不保证顺序;需有序用linkedhashmap::new;多字段分组推荐record组合键;统计数量用counting();key为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 联合分组。
立即学习“Java免费学习笔记(深入)”;
- 推荐方式:用 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<k long></k>,但很多人误以为要手动调 list.size()。其实 counting() 就是为此设计的下游收集器,性能比 mapping(..., toList()) + size() 好得多。
性能影响:对百万级数据,counting() 是单次遍历 O(n),而先收集再取 size 是 O(n) + 内存开销,还可能触发 GC。
- 正确写法:
Map<string long> countByType = list.stream().collect(Collectors.groupingBy(Item::getType, Collectors.counting()));</string> - 错误写法:
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。










