Stream.ofNullable()是Java 9引入的工具，用于将可能为null的单个对象转为最多含一个元素的流：非null时包含该对象，null时返回空流，天然支持“有则处理、无则跳过”逻辑。
Stream.ofNullable() 是 Java 9 引入的便捷工具，专为优雅处理可能为 null 的单个对象而设计。它不抛异常、不需提前判空、不生成空流，而是直接返回一个**最多含一个元素的流**：对象非 null 时含该对象，为 null 时返回空流（Stream.empty()）。这天然契合“有则处理、无则跳过”的业务逻辑。
避免冗余判空，让链式调用更干净
传统写法常需先判断再构建流，代码割裂且易出错：
if (user != null) {
Stream.of(user).filter(...).map(...).forEach(...);
}
用 Stream.ofNullable() 后，可一气呵成：
Stream.ofNullable(user)
.filter(u -> u.getAge() >= 18)
.map(User::getUsername)
.findFirst()
.ifPresent(System.out::println);
整个链条天然免疫 NullPointerException，user == null 时后续操作自动跳过，语义清晰，无副作用。
替代 Optional + map + stream 的繁琐组合
有人会用 Optional.ofNullable(user).map(Stream::of).orElseGet(Stream::empty)，虽可行但冗长且可读性差。而 Stream.ofNullable() 是官方提供的语义等价、零开销替代方案，一行顶三行，且不引入额外包装对象。
与集合类流配合，统一空值处理风格
当业务中既有单对象又有集合（如 List<User>），可保持一致的流式风格：
-
Stream.ofNullable(singleUser)→ 处理单个可能为空的对象 -
users == null ? Stream.empty() : users.stream()→ 旧写法，仍需判空 -
Stream.ofNullable(users).flatMap(Collection::stream)→ 更优雅地将可能为 null 的集合转为流（注意：此处利用了Collection::stream对 null 安全的前提是users非 null；若users可能为 null，flatMap内部会收到 null，导致 NPE；正确写法应为Stream.ofNullable(users).flatMap(uList -> uList == null ? Stream.empty() : uList.stream())，但更推荐先确保集合字段非 null，或使用Objects.requireNonNullElse(users, List.of()).stream()）
重点在于：对单对象，ofNullable 是最轻量、最直接的选择。
实际业务场景示例：订单详情安全组装
假设从数据库查出一个 Order，它关联的 Customer 和 Address 字段都可能为 null：
Stream.ofNullable(order)
.filter(Objects::nonNull) // 此行其实冗余，ofNullable 已保证非 null 元素
.flatMap(o -> Stream.ofNullable(o.getCustomer()))
.filter(c -> "VIP".equals(c.getLevel()))
.flatMap(c -> Stream.ofNullable(c.getAddress()))
.filter(a -> "Beijing".equals(a.getCity()))
.map(Address::getFullAddress)
.findFirst();
每一步都用 ofNullable 衔接下游可能为空的引用，整条链天然短路 —— 任一环节为 null，后续操作自动终止，最终结果为 Optional.empty()，无需层层 if 判断。
