为什么Stream的toMap()不允许重复key和null value？

1. 重复key的处理差异 #

HashMap的核心定位是键值对存储容器，它的put操作本身就设计为"重复key覆盖旧值"——这是哈希表的常规行为，开发者使用时默认预期这种覆盖逻辑，属于主动选择的业务操作。

而Collectors.toMap()是Stream流中的数据收集工具，它的设计初衷是将流中元素映射为唯一key的键值对集合。如果流中出现重复key，默认被视为意外的业务数据问题（比如数据重复、映射逻辑错误），而不是预期操作，所以会直接抛出IllegalStateException。当然你可以通过第三个参数自定义合并逻辑，比如指定覆盖旧值，和HashMap行为对齐：

// 自定义重复key时覆盖旧值
stream.collect(Collectors.toMap(keyMapper, valueMapper, (oldVal, newVal) -> newVal));

2. null value的处理差异 #

HashMap允许null value是因为它的API设计追求灵活性，开发者可以自行处理get()返回null的两种情况（key不存在/value本身是null），这是哈希表容器的通用设计选择。

而Collectors.toMap()底层依赖Map.merge()方法实现元素收集，而merge()方法的规范明确禁止传入null value（会抛出NullPointerException）。另外，Stream API的设计理念更偏向数据流的规范性，null通常被视为异常数据，鼓励开发者在流处理阶段就过滤或处理null，而不是将其带入最终的Map结果中。

内容的提问来源于stack exchange，提问作者great-jin