为什么JDK8中java.util.stream的Collectors.toMap不允许存在重复key？

核心设计逻辑围绕「避免静默数据丢失」展开，具体可以拆解为3个层面：

• 显式意图优先于隐式默认
  HashMap.put() 是单次操作的API，你主动调用put插入重复键时，上下文是可控的，默认覆盖的逻辑符合多数单次操作的预期。但Collectors.toMap 是面向批量数据转换的收集器，大多场景下你是将一批来源复杂的数据集转换为Map，此时出现重复键大概率是数据异常、或者上游转换逻辑有问题，并非你的预期行为。如果默认实现覆盖逻辑，会出现你完全感知不到的数据丢失，直到业务出问题才能回溯。所以JDK设计成直接抛出异常，强制你显式声明重复键的处理策略：是保留旧值、取新值、还是自定义聚合，从API层面规避隐式逻辑漏洞。
• 符合JDK的fail-fast设计原则
  JDK集合框架的设计一贯遵循fail-fast原则：当出现不符合预期的运行状态时，尽早抛出异常终止运行，而不是带着错误继续执行。双参数版本的Collectors.toMap的语义就是「输入数据的键不存在重复」，如果出现重复就是违反了预设的输入条件，直接抛异常能让你在开发测试阶段就发现问题，不用把风险带到线上。
• API语义分层清晰
  Collectors.toMap 提供了明确的重载语义：
  • 双参数版本（仅传keyMapper、valueMapper）：适用于输入无重复键的场景，重复即报错
  • 三参数版本（多传mergeFunction）：适用于输入可能存在重复键的场景，由你自定义合并逻辑
    两个版本的语义边界非常清楚，你可以根据自己的业务场景选择对应的API，不需要靠隐藏的默认行为猜逻辑。

java.util.stream.Collectors的源码注释里有明确说明：双参数toMap方法默认使用抛出异常的合并函数，当检测到重复键时直接抛出IllegalStateException。

内容的提问来源于stack exchange，提问作者cmfu