collectors.tomap() 遇重复 key 默认抛 illegalstateexception，需通过 mergefunction 明确冲突处理策略，如保留后值、先值、累加或合并集合；推荐用 groupingby 替代以规避冲突，并注意 null 安全与类型安全。
Java Stream API 的 Collectors.toMap() 在将集合转为 Map 时，若遇到重复 key，默认会抛出 IllegalStateException。这不是 bug，而是设计使然——Map 不允许重复键，Stream 需明确告知如何处理冲突。
用 mergeFunction 处理重复 key
最常用且推荐的方式是提供第三个参数：合并函数（BinaryOperator<v></v>），定义当 key 冲突时，新旧 value 如何取舍或合并。
-
保留后出现的值：
(oldValue, newValue) -> newValue（等价于Collectors.toMap(..., (a,b)->b)） -
保留先出现的值：
(oldValue, newValue) -> oldValue -
数值累加：如统计频次，
(sum, count) -> sum + count -
合并为集合：如 key→List
，可用 (list1, list2) -> { list1.addAll(list2); return list1; }，但更建议用groupingBy
避免冲突：确保 key 唯一或预处理
如果业务上 key 本该唯一，但数据不干净，可在 map 前过滤或去重。
- 用
distinct()去重（需对象实现equals/hashCode） - 用
filter()排除 null 或非法 key - 用
limit(1)或findFirst()确保每个 key 只取一个元素（适合“任意选一个”场景）
替代方案：用 groupingBy 更安全
当目标是“一个 key 对应多个 value”，直接用 Collectors.groupingBy() 更语义清晰、无需手动处理冲突。
-
stream.collect(groupingBy(User::getDept, mapping(User::getName, toList())))→Map<string list>></string> - 搭配
collectingAndThen可进一步转换 value，比如取第一个、求和、拼接等
注意 null 和类型安全
key 或 value 为 null 会导致 NullPointerException；泛型擦除也可能引发运行时类型异常。
- key 不能为 null —— HashMap 不支持 null key（除非显式用
computeIfAbsent等方式绕过） - value 可为 null（取决于具体 Map 实现），但多数收集器不接受 null value
- 若 value 类型涉及泛型（如
List<string></string>），确保 mapper 返回非 null 对象
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
