collectors.tomap默认不支持key重复，需用三或四参数重载指定merge函数实现value合并；可累加数值、拼接字符串或合并为集合，注意避免npe和副作用。
使用 Collectors.toMap 时，默认不支持一个 key 对应多个 value 的场景（会抛 IllegalStateException）。若需“动态合并多个 value”，核心思路是：**用 toMap 的三参数或四参数重载，显式指定 merge 函数（即冲突解决策略）**，将重复 key 对应的 value 按需聚合（如相加、拼接、转集合等）。
用三参数 toMap + mergeFunction 合并数值型 value
适用于 key 重复时对 value 做算术合并，例如统计相同 ID 的订单总金额：
List<order> orders = Arrays.asList(
new Order("A", 100.0),
new Order("B", 200.0),
new Order("A", 150.0)
);
Map<string double> totalAmountByOrderId = orders.stream()
.collect(Collectors.toMap(
Order::getId, // keyMapper
Order::getAmount, // valueMapper
(v1, v2) -> v1 + v2 // mergeFunction：重复 key 时累加
));
// 结果：{"A"=250.0, "B"=200.0}
</string></order>
用四参数 toMap 控制 map 类型与合并逻辑
当需要指定具体 Map 实现类（如 LinkedHashMap 保序），或 merge 逻辑较复杂时，用四参数版本：
- 第 1 个参数：key mapper
- 第 2 个参数：value mapper
- 第 3 个参数：merge function（必填，处理冲突）
- 第 4 个参数：map supplier（如
LinkedHashMap::new）
示例：按品类分组，合并商品名称为逗号分隔字符串：
Map<string string> namesByCategory = products.stream()
.collect(Collectors.toMap(
Product::getCategory,
Product::getName,
(name1, name2) -> name1 + ", " + name2,
LinkedHashMap::new
));
</string>
合并为 List 或 Set 避免丢失数据
若原始 value 信息需全部保留（而非简单计算），推荐将 value 转为集合类型：
- 用
Collectors.groupingBy更直观（但题目限定用toMap） - 用
toMap时，valueMapper 返回单元素集合，mergeFunction 合并集合
示例：构建 Map<string list>></string>（注意初始化空 list 防 NPE）：
Map<string list>> tagsByUser = users.stream()
.collect(Collectors.toMap(
User::getName,
u -> Arrays.asList(u.getPrimaryTag()), // 单元素 list
(list1, list2) -> {
List<string> merged = new ArrayList(list1);
merged.addAll(list2);
return merged;
},
LinkedHashMap::new
));
</string></string>
常见陷阱与注意事项
直接使用双参数 toMap(keyMapper, valueMapper) 遇到重复 key 必然失败。务必检查数据中是否存在预期外的 key 冲突。mergeFunction 中避免副作用（如修改入参对象），保持函数式纯度。若 value 本身为 null，mergeFunction 需额外判空，否则可能触发 NullPointerException。
