Collectors.mapping() 的核心作用是“转换后归并”，即对每个流元素执行映射后再交由下游收集器处理；它不改变分组逻辑，必须作为 downstream collector 传入 groupingBy() 才能作用于每组内部，且不处理 null、要求类型严格匹配。
Collectors.mapping() 的核心作用不是“分流”，而是“转换后归并”
很多人误以为 Collectors.mapping() 能直接配合 Collectors.groupingBy() 实现“先分组再对每个组内元素做独立转换”，其实它只负责在收集前对每个流元素做一次映射，不改变分组逻辑本身。真正起分流作用的是 groupingBy() 或 partitioningBy()；mapping() 只是把传给下游收集器的值提前换掉。
正确组合：groupingBy + mapping + downstream collector
典型场景是：按某个字段分组后，不保留原始对象，而是提取/转换其中某个属性（比如转成字符串、转大写、转为 DTO）。这时必须把 mapping() 当作下游收集器（downstream collector）传入 groupingBy()，否则它只会映射单个元素，无法作用于每组内部。
常见错误写法：Collectors.groupingBy(p -> p.getDept(), Collectors.mapping(p -> p.getName(), Collectors.toList())) —— 这才是对的；而写成 Stream.collect(Collectors.mapping(...), Collectors.groupingBy(...)) 会编译失败。
-
mapping()第一个参数是映射函数（Function<t u></t>），第二个参数是下游收集器（如toList()、toSet()、counting()） - 如果下游用
Collectors.counting()，那mapping()的映射结果实际被丢弃，只计数——此时映射无意义，纯属误用 - 若想对每组做更复杂转换（比如转成 Map 或嵌套结构），应把
mapping()和toMap()或collectingAndThen()组合，而非硬塞进groupingBy()
容易踩的空指针和类型不匹配坑
mapping() 内部不做 null 安全处理。如果映射函数返回 null（比如 p.getName() 为 null），后续下游收集器（尤其是 toSet() 或 toMap()）可能直接抛 NullPointerException。
- 安全做法：在映射函数里显式处理 null，例如
p -> Optional.ofNullable(p.getName()).orElse("N/A") - 类型必须严格匹配下游收集器要求：比如下游是
Collectors.toSet()，映射函数返回类型就得是可比较/可哈希的；若下游是Collectors.summingInt()，映射函数必须返回int或包装类 - 不要试图用
mapping()做多步转换（如先取名再转大写再截取前3字符）——应封装成一个清晰的 lambda 或方法引用，保持可读性
替代方案：当 mapping 不够用时，用 collectingAndThen 或自定义 Collector
如果需要对每组结果再做一次整体转换（比如把 List<string></string> 转成用逗号拼接的字符串），mapping() 无能为力，因为它只作用于单个元素。这时该用 Collectors.collectingAndThen() 包裹整个下游收集器。
示例：分组后把每组名字列表转成大写并拼接
Map<String, String> deptToNames = persons.stream()
.collect(Collectors.groupingBy(
Person::getDept,
Collectors.collectingAndThen(
Collectors.mapping(p -> p.getName().toUpperCase(),
Collectors.joining(", ")),
s -> s.isEmpty() ? "(none)" : s
)
));
这个结构里，mapping() 负责每个名字转大写，joining() 把它们拼起来，collectingAndThen() 最后统一处理空字符串——三层嵌套各司其职，改错或调试时边界清晰。
真正难的不是写法，而是分清“对每个元素做啥”和“对整组结果做啥”——这个边界模糊了，就容易把逻辑堆在 mapping 里硬凑，最后谁也看不懂。
