如何通过 Stream.ofNullable() 安全地将可能为空的对象转换为包含零或一个元素的流？

本文共计917个文字，预计阅读时间需要4分钟。

该库专门设计为处理可能为null的单个值。内部自动跳过null，避免抛出NullPointerException。不再需要编写如下的样板逻辑：

常见误用是拿它处理集合或数组——它只接受一个参数，传 list 或 array 会把整个容器当一个元素放进流里，不是你想要的「展开」效果。

• 适用场景：包装返回值不确定是否为 null 的方法调用，比如 Optional.orElse(null)、DAO 查询单条记录、HTTP 响应体解析后可能为 null 的 DTO
• 不适用场景：处理 List<String>、String[]、或需要过滤/映射后再判断是否为空的情况
• 性能上无额外开销，比手动判空 + 构造流更轻量，且语义更清晰

正确用法：传入单个可能为 null 的引用类型

必须确保参数是明确的、非集合类型的引用变量或表达式。编译器不会帮你检查运行时是否真为 null，但至少类型安全。