Java 8 Stream 收集集合时报 NullPointerException，通常是因为流源对象为 null 或收集器不支持 null 元素。优先检查集合实例是否初始化，再确认是否使用了 Collectors.toMap 等对空值敏感的收集器。

快速处理思路

若无法立即修改业务逻辑，可在 Stream 管道前端增加空值防御代码。以下代码片段用于防止流源为 null 或元素为 null 导致的异常。

List<String> safeList = Optional.ofNullable(originalList)
    .orElse(Collections.emptyList());

List<String> result = safeList.stream()
    .filter(Objects::nonNull)
    .collect(Collectors.toList());

若使用 Collectors.toMap，需确保 key 和 value 均不为 null，否则需自定义合并函数或过滤。

为什么会这样

Stream 管道中的空值在特定收集器或中间操作中会触发异常。Java 8 标准收集器中，Collectors.toList() 允许元素为 null，但 Collectors.toMap() 明确禁止 key 或 value 为 null。

调用 .stream() 方法本身是实例方法，若集合引用为 null， JVM 无法调用该方法，直接抛出 NullPointerException。此外，中间操作如 .map(String::length) 若遇到 null 元素，也会在计算时抛出异常，堆栈可能指向 collect 阶段。

分步处理

按以下顺序排查代码，定位空值来源并修复。

步骤 1：检查流源对象

在调用 .stream() 之前打印或断点检查集合对象。若集合可能为 null，使用 Optional 或三元运算符提供空列表默认值。

List<Item> list = (data == null) ? Collections.emptyList() : data;

步骤 2：检查中间操作

review 所有 .map()、.filter() 中的 Lambda 表达式。若方法调用链中包含对象方法（如 obj.getMethod()），需确保 obj 不为 null。

步骤 3：检查收集器类型

若使用 Collectors.toMap()，检查映射函数是否可能返回 null。若业务允许 null 值，改用 Collectors.toList() 或自定义收集器。

Map<String, Integer> map = list.stream()
    .filter(Objects::nonNull)
    .collect(Collectors.toMap(Item::getKey, Item::getValue, (v1, v2) -> v1));

怎么验证是否生效

编写单元测试覆盖边界条件，确认不再抛出异常。

验证点 1：空集合输入

传入 null 或 emptyList，程序应返回空结果而非崩溃。

验证点 2：含 null 元素输入

传入包含 null 元素的列表，经 filter 处理后应正常收集。

验证点 3：日志检查

生产环境若已报错，检查异常堆栈。若堆栈指向 .stream() 行，说明集合为 null；若指向 Lambda 内部，说明元素为 null。

常见坑

以下场景容易重复触发 NullPointerException，需谨慎处理。

• Collectors.toMap() 的 value 为 null：官方实现不支持 null 值，会直接抛异常。
• Collectors.groupingBy() 的分类函数返回 null：分类键不能为 null。
• 并行流 parallelStream()：若存在竞态条件修改集合，可能偶发空指针，建议避免在流操作中修改外部状态。
• 自动装箱：基本类型与包装类型转换时，若包装类型为 null，拆箱会报 NPE。

常见问题

Collectors.toList() 支持 null 元素吗？

支持。ArrayList 底层允许存储 null，但流源本身不能为 null。

Collectors.toMap() 遇到 null 值怎么办？

会抛出 NullPointerException。需先在 stream 中 filter 掉 null 值，或提供默认值。

stream() 前必须判空吗？

建议判空。若集合字段可能为 null，直接调用 .stream() 必报空指针。

参考来源

• Oracle Java Documentation, Class Collectors (Java Platform SE 8 ), https://docs.oracle.com/javase/8/docs/api/java/util/stream/Collectors.html