应优先在流操作中过滤或封装null而非事后捕获npe:创建阶段用filter(objects::nonnull)清洗数据;map/flatmap中用optional安全展开;终端操作前明确空值语义;配合@nonnull注解与静态检查守住入口。

直接在流操作中对元素判空,比事后捕获 NullPointerException 更可靠。关键不是“等它崩”,而是让流本身拒绝 null 元素或安全绕过——把空值处理收敛到数据源头和管道内。
流创建阶段就过滤掉 null
很多 NPE 出现在 list.stream().map(...) 里,只因原始集合含 null 元素。与其在 map 里反复判空,不如一开始就剔除:
- 用
filter(Objects::nonNull)清洗数据:list.stream().filter(Objects::nonNull).map(User::getName).collect(Collectors.toList()) - 对可能含 null 的数组,先转为 Stream 再过滤:
Stream.of(arr).filter(Objects::nonNull).map(String::toUpperCase).toList() - 数据库查询结果映射后若含 null,建议 DAO 层统一返回非 null 集合(如
Collections.emptyList()),避免 null 进入流管道
map/flatMap 中用 Optional 封装转化逻辑
当映射目标可能为 null(比如调用一个可能返回 null 的方法),别裸写 user.getAddress().getCity(),改用 Optional 链式安全展开:
stream.map(u -> Optional.ofNullable(u).map(User::getAddress).map(Address::getCity).orElse(""))- 把易崩的嵌套访问封装成工具方法:
safeGet(() -> user.getAddress().getCity(), ""),内部用 try-catch 或 Optional 捕获并兜底 - 避免在 map 里直接调用可能返回 null 的 getter;优先让领域对象自身提供安全访问方法,例如
user.safeCityName()返回Optional<string></string>
终端操作前统一处理空值语义
collect、reduce、findFirst 等操作对 null 敏感,需提前明确“空”代表什么:
-
findFirst()返回Optional,天然防 NPE;但若后续调用.get()仍危险,应改用orElse("")或map(...).orElse(null) -
reduce初始值不能为 null,尤其涉及字符串拼接或数值计算时,用""或0替代null - 聚合到 Map 时,key 或 value 为 null 会抛异常,可用
Collectors.toMap(k -> k.getName(), v -> v.getId(), (a,b)->a, HashMap::new)并确保 key/value 非 null,或先 filter
配合注解与静态检查守住入口
流的源头(集合、数组、方法返回值)若标注了 @NonNull,IDE 和 SpotBugs 就能在编译期提示潜在 null 流入:
- DAO 方法返回
List,表示集合不为 null,且每个元素也不为 null - DTO 字段加
@NonNull,Lombok 的@RequiredArgsConstructor会在构造时校验,防止 null 值进入流处理链 - 自定义 Collector 时,在
accumulator和combiner中主动判空,避免 null 被累积











