默认返回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免费学习笔记（深入）”；
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
- 推荐方式：用 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。
