应使用三参数tomap重载并提供mergefunction，如(v1,v2)->v1保留首个值；若需分组聚合则改用groupingby，避免强行用tomap拼集合。
Collectors.toMap 报 IllegalStateException: Duplicate key 怎么办
直接原因：你传给 toMap 的 key 生成逻辑产生了重复值，而默认的 toMap(keyMapper, valueMapper) 重载不接受冲突处理策略，遇到重复 key 就炸。
这不是数据“有问题”，而是你没告诉 Java 遇到重复时该留哪个、怎么合并。常见于用 ID 字段当 key，但 List 里恰好有两条相同 ID 的对象（比如测试数据没去重、或上游逻辑本就允许临时重复）。
- 必须用三参数或四参数的
toMap重载，显式提供mergeFunction - 如果只关心“保留第一个”，用
(v1, v2) -> v1；要“覆盖为最新”，用(v1, v2) -> v2 - 若需合并值（比如把重复 key 对应的多个对象聚合成 list），
toMap不适合，改用groupingBy+mapping
用 toMap 保留第一个重复 key 对应的 value
最常用场景：去重取首条，比如从一堆用户记录中按 userId 构建缓存 Map，重复时信任先出现的数据。
关键不是“过滤掉重复”，而是让收集器自己决定留谁——靠第三个参数 BinaryOperator。
立即学习“Java免费学习笔记（深入）”；
Map<Long, User> userMap = users.stream()
.collect(Collectors.toMap(
User::getId, // keyMapper
Function.identity(), // valueMapper
(v1, v2) -> v1 // mergeFunction：v1 是已存在的，v2 是新的，选 v1
));
-
(v1, v2) -> v1和(v1, v2) -> v2看似简单，但顺序由 stream 处理顺序决定，不保证稳定（除非源是ArrayList且未并行） - 别写成
(a, b) -> a后又在别处依赖b，语义不清，直接用v1/v2表明角色 - 如果 stream 是并行的（
parallelStream()），这个 merge 函数必须是无状态且可结合的——(v1, v2) -> v1满足，但自定义复杂逻辑可能不满足
toMap 的四个参数重载：什么时候必须用它
第四个参数是 Supplier<m></m>，用来指定返回的 Map 类型，比如你要 LinkedHashMap 保序，或 ConcurrentHashMap 支持并发写入。
只有当你同时需要：① 自定义 key 冲突策略 + ② 指定具体 Map 实现类，才必须上四参数版。
Map<String, Integer> countMap = words.stream()
.collect(Collectors.toMap(
word -> word.toLowerCase(),
word -> 1,
Integer::sum,
LinkedHashMap::new // 保证插入顺序，可用于 TopN 场景
));
- 第三个参数
mergeFunction在 key 冲突时必执行，哪怕你只是想抛个更友好的错，也可以写成(v1, v2) -> { throw new IllegalArgumentException("Duplicate key: " + v1); } - 第四个参数如果不用，
toMap默认返回HashMap，不保序、非线程安全 - 别为了“看起来完整”硬凑四参数——多数业务场景两个或三个参数够用
Key 重复但想聚合多个 value？别硬刚 toMap
toMap 的设计目标是“一对一映射”，强行用 mergeFunction 拼 list 或 set，代码难读、易出 bug，还绕过类型安全。
真正想做“按某字段分组汇总”，应该用 groupingBy —— 它天生为多对一设计，语义清晰，扩展性强。
// 错误示范：用 toMap 拼 list（冗余、易空指针）
Map<Long, List<User>> map = users.stream()
.collect(Collectors.toMap(
User::getDeptId,
u -> Arrays.asList(u),
(list1, list2) -> {
List<User> merged = new ArrayList<>(list1);
merged.addAll(list2);
return merged;
}
));
// 正确做法：用 groupingBy + mapping
Map<Long, List<User>> map = users.stream()
.collect(Collectors.groupingBy(
User::getDeptId,
Collectors.mapping(Function.identity(), Collectors.toList())
));
-
groupingBy内置处理重复 key，无需手动 merge - 后续想换成
toSet()或统计数量counting()，只改最后一层 collector，结构不变 - 如果真要用
toMap返回Map<k list>></k>，说明你其实想要分组，只是没意识到
