Collectors.toMap 的 mergeFunction 用于处理键重复时的值合并，接收旧值和新值并返回最终值，常见逻辑包括累加、取最值、覆盖或构建新对象，需注意 null 和不可变类型处理。
使用 Collectors.toMap 时，若键存在重复，默认会抛出 IllegalStateException。要实现“根据特定逻辑在转换映射时进行变量预合并”，关键在于提供第三个参数——mergeFunction，它定义当多个元素映射到同一键时如何合并对应的值。
明确 mergeFunction 的作用时机与签名
该函数在流处理过程中，每当遇到新元素的键已存在于当前 Map 中时被调用，接收两个参数：
- 第一个：已存在的旧值（之前通过映射函数生成的 value）
- 第二个：当前新元素生成的新值
返回值即为该键最终保留的 value。
常见写法示例：
-
(oldV, newV) -> oldV + newV—— 数值累加 -
(oldV, newV) -> oldV > newV ? oldV : newV—— 取最大值 -
(oldV, newV) -> newV—— 覆盖为最新值（等效于toMap(..., (a,b)->b)） -
(oldV, newV) -> Stream.of(oldV, newV).flatMap(Collection::stream).collect(Collectors.toList())—— 合并为列表（需确保 value 类型支持）
结合对象属性提取与自定义合并逻辑
例如，有一组订单 Order，希望按用户 ID 分组，同时将每个用户的订单金额汇总，并保留最早下单时间：
Map<Long, OrderSummary> summaryMap = orders.stream()
.collect(Collectors.toMap(
Order::getUserId,
order -> new OrderSummary(order.getAmount(), order.getCreateTime()),
(oldSum, newSum) -> new OrderSummary(
oldSum.getAmount() + newSum.getAmount(),
oldSum.getFirstTime().isBefore(newSum.getFirstTime())
? oldSum.getFirstTime()
: newSum.getFirstTime()
)
));这里 value 是自定义对象，mergeFunction 实现了金额相加 + 时间取早的复合逻辑。
注意 null 值与不可变类型的处理
如果 value 类型本身不可变（如 String、Integer），合并必须构造新实例；若涉及 null，需主动判空：
- 避免直接调用
oldV.toString()等可能 NPE 的操作 - 推荐写法：
(a, b) -> Optional.ofNullable(a).orElse(0) + Optional.ofNullable(b).orElse(0) - 若原始流中 value 可能为 null，建议前置过滤或映射为默认值
替代方案：先分组再映射（适合复杂合并）
当合并逻辑较重（如需遍历多个同键元素、调用外部服务、涉及副作用），toMap 的二元 merge 函数可能不够直观。此时可改用：
Map<Long, List<Order>> grouped = orders.stream()
.collect(Collectors.groupingBy(Order::getUserId));
<p>Map<Long, OrderSummary> result = grouped.entrySet().stream()
.collect(Collectors.toMap(
Map.Entry::getKey,
entry -> buildSummary(entry.getValue()) // 自定义方法，任意复杂度
));这种方式更清晰、易测试，也便于复用分组结果。
