Collectors.toMap() 遇重复键抛 IllegalStateException 是设计使然，需用 mergeFunction 明确冲突策略，如覆盖、保留旧值、累加等；推荐 groupingBy 处理多值场景，或提前校验保证 key 唯一。
遇到重复键时，Collectors.toMap() 默认抛 IllegalStateException，这不是 bug，而是强制你明确处理冲突——避免数据被静默覆盖。
用 mergeFunction 明确合并逻辑
第三个参数是 BinaryOperator<U>，它在发现相同 key 时被调用，接收旧值和新值，返回最终保留的值：
- 保留后出现的值（覆盖）：
(oldVal, newVal) -> newVal - 保留先出现的值（跳过）：
(oldVal, newVal) -> oldVal - 数值累加：
(sum, n) -> sum + n - 取较大值：
(a, b) -> Math.max(a, b) - 字符串拼接（带分隔）：
(s1, s2) -> s1 + ", " + s2
注意：该函数不能返回 null；必须是无状态、无副作用的纯函数；用于并行流时需满足结合律；返回类型必须严格匹配 value 类型。
改用 groupingBy 更自然地支持多值
当一个 key 天然对应多个 value（比如同名用户、多仓库 SKU），groupingBy 语义更清晰，也省去手动合并：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记（深入）”；
-
stream.collect(groupingBy(User::getName, mapping(User::getAge, toList())))→Map<String, List<Integer>> - 搭配
collectingAndThen可进一步加工，如取第一个、求和、拼接等 - 若仍想用
toMap，可让 value mapper 返回单元素集合，再用 merge 函数合并两个List
提前过滤或校验，让 key 天然唯一
如果业务上 key 本该唯一（如 ID、订单号），那异常其实是提醒你数据不干净：
- 用
filter(Objects::nonNull)剔除 null 元素，防止NullPointerException - 用
distinct()去重（需对象正确实现equals/hashCode） - 用
groupingBy(keyMapper, counting())统计频次，提前发现重复并告警 - 对复合 key（如 name+city），封装成自定义对象并重写
equals/hashCode
其他实用细节
四参数版本可指定 map 构造器（如 LinkedHashMap::new），保持插入顺序便于调试；但依然需要提供 mergeFunction 才能解决冲突。不要为了“不报错”而盲目用 (v1,v2)->v2，掩盖真实的数据质量问题。
