collectors.tomap() 遇重复键抛 illegalstateexception，需用 mergefunction 明确处理：覆盖（→newval）、保留旧值（→oldval）、累加、取大、拼接；须满足非空、纯函数、结合律、类型一致；多值建议用 groupingby 或转集合合并。
遇到重复键时，Collectors.toMap() 默认会抛出 IllegalStateException: Duplicate key。这不是异常，而是设计提醒——它强制你明确处理冲突，避免数据被静默覆盖。
提供 mergeFunction 是最直接的解决方式
第三个参数 BinaryOperator<u></u> 就是合并函数，它在检测到相同 key 时被调用，接收已存在的旧值和新值，返回最终保留的值。
-
保留后出现的值（覆盖）：
(oldVal, newVal) -> newVal -
保留先出现的值（跳过）：
(oldVal, newVal) -> oldVal -
数值累加：
(sum, n) -> sum + n -
取较大值：
(a, b) -> Math.max(a, b) -
字符串拼接（带分隔）：
(s1, s2) -> s1 + ", " + s2
合并函数必须满足基本约束
这个函数看似简单，但写错会导致运行时报错或逻辑错误：
- 不能返回
null（除非 value 类型允许且 map 实现支持） - 应是无状态、无副作用的纯函数（不修改外部变量、不打印日志、不调用非确定性方法）
- 若用于并行流，需满足结合律（例如
a + b + c无论怎么分组结果一致） - 返回值类型必须与 value 类型严格一致（Java 不做自动装箱推导）
按业务含义聚合多个值更安全
单纯覆盖会丢失信息。当一个键天然可能对应多个实体时，建议把值转为集合：
- 用
Collectors.groupingBy()更自然：groupingBy(Person::getName, mapping(Person::getAge, toList())) - 若坚持用
toMap，value mapper 返回单元素列表，mergeFunction 合并两个列表：(list1, list2) -> { var merged = new ArrayList(list1); merged.addAll(list2); return merged; }
其他辅助策略也值得考虑
不是所有场景都适合覆盖或合并：
- 如果 key 理应唯一（如 ID），可在收集前用
groupingBy(..., counting())检查重复，提前报错或告警 - 使用四参数重载指定
LinkedHashMap::new，可保持插入顺序，便于调试 - 对复合键（如 name + city），改用自定义 key 对象并重写
equals/hashCode，从源头避免冲突
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
