Collectors.toMap() 遇重复键默认抛 IllegalStateException，需传入 BinaryOperator 指定新旧值合并策略，如保留旧值、新值、求和或取最新等，且须注意 null 安全、结合律、无副作用及类型匹配。
当使用 Collectors.toMap() 将流转换为 Map 时，若流中存在重复的键，默认会抛出 IllegalStateException。解决的关键在于传入第三个参数——一个 BinaryOperator，用于定义“当键已存在时，新旧值如何合并”。
理解 BinaryOperator 的作用
这个函数接收两个参数：已存在的旧值（oldValue）和当前要插入的新值（newValue），返回最终应保留的值。它不决定是否覆盖，而是明确指定“保留哪一个”或“如何合成”。例如：
-
(old, new) -> old：保留旧值（即跳过新值） -
(old, new) -> new：保留新值（默认行为，但显式写出更清晰） -
(a, b) -> a + b：对数值型 value 求和 -
(first, second) -> first.length() >= second.length() ? first : second：保留更长的字符串
常见实用场景与写法
实际开发中，冲突处理往往不是简单覆盖，而是有业务含义的合并：
-
累计统计：按用户 ID 分组计数，遇到相同 ID 时累加次数 ——
(sum, count) -> sum + count -
取最新/最全数据：用时间戳字段判断，保留更新的记录 ——
(prev, curr) -> prev.getTimestamp().isAfter(curr.getTimestamp()) ? prev : curr -
构建集合类 value：将多个值聚合成
List或Set—— 需配合Collectors.groupingBy()更自然；若坚持用toMap，可写(list1, list2) -> { list1.addAll(list2); return list1; }（注意线程安全与可变性）
注意事项与避坑点
这个看似简单的参数，容易引发隐性问题：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
-
Null 安全必须自行保障：如果 oldValue 或 newValue 可能为 null，Lambda 中需判空，否则触发
NullPointerException -
函数需满足结合律（如需并行流）：若用
parallelStream()，合并逻辑应支持任意分组顺序（如a+b满足，但a.substring(0,1)不满足） -
避免副作用：不要在 Lambda 中修改外部集合、调用非纯方法（如
System.out.println），这会破坏函数式语义且难以调试 - 类型匹配要一致：返回值类型必须与 value 类型完全一致，Java 不会自动装箱/泛型推导，写错会导致编译失败
完整示例：按城市聚合用户平均年龄
假设有 User(name, city, age) 列表，想得到 Map<string double></string> 表示每个城市的平均年龄。虽然更适合用 Collectors.groupingBy + Collectors.averagingDouble，但用 toMap 演示冲突处理逻辑如下：
Map<String, double[]> temp = users.stream()
.collect(Collectors.toMap(
User::getCity,
u -> new double[]{u.getAge(), 1.0}, // [sum, count]
(a, b) -> new double[]{a[0] + b[0], a[1] + b[1]} // 合并 sum 和 count
));
Map<String, Double> avgByCity = temp.entrySet().stream()
.collect(Collectors.toMap(
Map.Entry::getKey,
e -> e.getValue()[0] / e.getValue()[1]
));
这里两次用到 BinaryOperator：第一次聚合中间状态，第二次确保 map 构建无冲突。
