Java中Collectors.toMap()存null值抛空指针的原因及解决方法

一、为何Collectors.toMap()值为null时抛NPE，HashMap却允许？ #

这是因为Collectors.toMap()的底层实现依赖于Map.merge()方法，而Map.merge()的规范明确要求：当传入的value为null时，必须抛出NullPointerException，无论底层使用的Map（比如HashMap）是否支持null值。

查看Collectors.toMap()的源码会发现，其累加器逻辑是调用map.merge(key, value, remappingFunction)，而merge方法的设计初衷是处理键冲突时的合并逻辑，它不接受null作为新值——即使HashMap本身允许put(null)，merge也会直接拦截并抛异常。这就是为什么手动遍历用HashMap.put()没问题，但用toMap会报错的核心原因。

二、无需手动遍历的安全实现方案 #

可以使用Stream.collect()的三元重载版本，直接指定HashMap作为目标容器，并调用其put方法（而非merge），这样就能保留null值：

Map<Long, String> result = products.stream()
    .filter(pt -> pt.getId() != null)
    .collect(HashMap::new,
             (map, product) -> map.put(product.getId(), product.getLogoPath()),
             HashMap::putAll);

这个实现的逻辑和手动遍历完全一致：先过滤掉id为null的元素，然后逐个将id和logoPath（允许null）放入HashMap中，既利用了Stream的简洁性，又避免了merge方法的限制。

另外，如果你偏好使用Collectors风格的写法，也可以自定义一个支持null值的收集器：

public static <T, K, V> Collector<T, ?, Map<K, V>> toNullableMap(Function<? super T, ? extends K> keyMapper, Function<? super T, ? extends V> valueMapper) {
    return Collectors.collectingAndThen(
        Collectors.toList(),
        list -> {
            Map<K, V> map = new HashMap<>();
            list.forEach(item -> map.put(keyMapper.apply(item), valueMapper.apply(item)));
            return map;
        }
    );
}

使用时直接调用这个自定义收集器即可：

Map<Long, String> result = products.stream()
    .filter(pt -> pt.getId() != null)
    .collect(toNullableMap(Products::getId, Products::getLogoPath));

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