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