Stream不可变且惰性求值,需终端操作触发执行;类型链式传递须匹配;并行流忌共享状态;null需显式处理。

Stream 不能修改原集合,所有操作都是惰性求值
Java 的 Stream 是不可变的、一次性的数据管道,调用 filter、map 等方法不会改变原始 List 或 Set。常见误解是以为 stream().forEach(System.out::println) 之后原集合被“处理完了”,其实它只是消费了一次流;再次调用会抛出 IllegalStateException: stream has already been operated upon or closed。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 需要结果时,必须显式终止流:用
collect(Collectors.toList())、findFirst()、count()等终端操作 - 避免在
forEach中做副作用操作(如修改外部变量),优先用map+collect构建新集合 - 调试时别只看中间操作链,要确认有没有终端操作——没有就什么都不会执行
filter 和 map 的参数类型必须匹配泛型,否则编译失败
filter 接收 Predicate,map 接收 Function,它们对泛型推导很敏感。比如从 List 开始,却在 map 里返回 Integer,没问题;但若误写成 map(s -> s.length() + "") 想转成字符串,而后续又接了 filter(n -> n > 5),就会因类型不匹配编译报错:incompatible types: java.lang.String cannot be converted to int。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 链式调用中每一步的输出类型,就是下一步的输入类型——用 IDE 的类型提示(如 IntelliJ 的 Ctrl+Shift+P)实时确认
- 避免隐式装箱/拆箱陷阱:对
int流用mapToInt,而不是在map里返回int再强转 - 复杂转换建议拆成独立方法或使用方法引用,提高可读性和类型稳定性,例如
map(Person::getName)比map(p -> p.getName())更易推导
并行流不是万能加速器,共享可变状态会导致结果错误
parallelStream() 默认使用 ForkJoinPool.commonPool(),适合无状态、CPU 密集型计算。但一旦在 forEach 或 reduce 中修改外部 ArrayList、HashMap 或静态计数器,就可能因多线程竞态导致漏数据、重复添加或 ConcurrentModificationException。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 并行场景下,收集结果统一用
collect(Collectors.toList())或Collectors.toConcurrentMap(),不要用forEach(list::add) - 简单聚合优先用
reduce或专用终端操作(如summingInt),而非手写同步块 - 小集合(
空指针异常常发生在 map 或 flatMap 的返回值为 null 时
map 函数如果返回 null,后续调用 filter 或 collect 不会报错,但一旦触发 Optional.get() 或解包操作(如 flatMap 内部调用 Stream.ofNullable 失败),就会在运行时崩掉。典型例子:list.stream().map(String::toUpperCase).filter(Objects::nonNull).collect(...) 看似防御,但如果 toUpperCase 前原始元素就是 null,第一步就已 NPE。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 上游数据不确定是否为空时,在
map前先用filter(Objects::nonNull)过滤 - 需要安全转换,用
map(s -> s == null ? "N/A" : s.toUpperCase())显式处理 null - 嵌套结构扁平化时慎用
flatMap:如果某对象的子列表字段为null,应先filter(x -> x.getChildren() != null)或改用flatMap(x -> Optional.ofNullable(x.getChildren()).orElse(List.of()).stream())
List流的真正难点不在语法,而在理解「数据源不可变」「操作惰性化」「类型流式传递」这三层约束。写完一行 Stream 链,先问自己:输入类型是什么?每步输出类型是否匹配?有没有终端操作?有没有隐藏的 null 或共享状态?这几个问题卡住的地方,往往就是 bug 所在。names = Arrays.asList("alice", null, "bob"); List upperNames = names.stream() .filter(Objects::nonNull) // 先过滤 null .map(String::toUpperCase) .collect(Collectors.toList()); // 必须有终端操作










