Collectors.toMap 抛出 IllegalStateException：Duplicate key 是因 Map 的 key 必须唯一，而输入 key 列表存在重复值；解决方式包括校验数据、使用 mergeFunction 处理冲突或显式指定 map 工厂。
Collectors.toMap 为什么抛出 IllegalStateException：Duplicate key
用 Collectors.toMap 合并两个 List 时最常遇到的错误就是这个——它默认不允许重复 key。比如你拿 list1 做 key，list2 做 value，但 list1 里有相同元素，就会炸。
- 这不是 bug，是设计使然：Map 的 key 必须唯一，
toMap不会自动覆盖或跳过，而是直接抛IllegalStateException: Duplicate key - 常见场景：用 ID 列表和对应名称列表拼 Map，但 ID 列表本身含重复值（比如数据库没去重、前端传参重复）
- 别急着改逻辑，先确认是不是真要保留所有映射——有时“重复 key”恰恰暴露了业务数据问题
用 zip 方式合并两个 List：避免手动 for 循环索引越界
Java 没原生 zip，但用 IntStream.range + mapToObj 可安全配对两个等长 List，比传统 for 更函数式、也更防错。
- 必须确保两 List 长度一致，否则会丢数据；建议加校验：
if (list1.size() != list2.size()) throw new IllegalArgumentException(...) - 示例写法：
Map<String, Integer> map = IntStream.range(0, list1.size()) .boxed() .collect(Collectors.toMap( i -> list1.get(i), i -> list2.get(i) )); - 如果长度不等还想“尽量合并”，可用
Math.min(list1.size(), list2.size())替代list1.size()
处理重复 key：用 mergeFunction 参数接管冲突逻辑
真正需要覆盖或聚合时，别绕开 toMap 的第三个参数——mergeFunction 就是干这个的。
- 签名是
(oldValue, newValue) -> newValue，返回谁，key 对应的 value 就变成谁 - 想保留第一个值（首次出现的）：
(a, b) -> a；想保留最后一个：(a, b) -> b - 想合并成 List？可以，但注意类型要匹配：
toMap(k -> k, v -> Arrays.asList(v), (a, b) -> { List<t> r = new ArrayList(a); r.addAll(b); return r; })</t> - 别漏掉第四个参数：如果 key 类型不是 String/Integer 等默认可比较类型，得传
HashMap::new显式指定 map 工厂
性能与兼容性提醒：Stream + toMap 不等于万能拼接
小数据量没问题，但上万条时要注意两件事：一是中间 Stream 的开销，二是 Map 实现的选择。
立即学习“Java免费学习笔记（深入）”；
- 如果只是简单键值对合并，且 key 是基础类型，用
HashMap足够；但若需有序，别指望toMap默认返回LinkedHashMap—— 必须显式传第四个参数：LinkedHashMap::new - 频繁调用？考虑缓存或预构建；流式拼接每次都是新对象，不会复用已有 Map
- Android 开发注意：旧版 SDK（Collectors.toMap，得用
forEach手动 put，或引入 desugaring
最容易被忽略的是 key 的 equals/hashCode 实现——自定义对象作 key 时，没重写这两个方法，toMap 表面成功，实际查不到值。
