Optional.ofNullable 是唯一能安全处理 null 的静态工厂方法，传入 null 返回 Optional.empty()，非 null 则包装为 Optional；而 Optional.of(null) 会抛出 NullPointerException。
Optional.ofNullable 是 Java 8 引入的 Optional 工具类中**唯一能安全处理 null 值的静态工厂方法**。它不会抛出异常，而是当传入 null 时自动返回一个空的 Optional.empty()；非 null 时则包装为 Optional.of(value)。
为什么不能用 Optional.of？
Optional.of(null) 会直接抛出 NullPointerException，因为它假定参数一定非 null。而真实业务中，从数据库查询、远程调用、用户输入等场景返回的值常常可能为 null，必须先判空再包装——ofNullable 就是为此设计的“一步到位”方案。
基本用法：一行完成安全包装
直接把可能为 null 的变量传给 ofNullable：
Optional<string> opt = Optional.ofNullable(getUserName());</string>Optional<user> userOpt = Optional.ofNullable(findUserById(123));</user>Optional<integer> countOpt = Optional.ofNullable(getItemCount());</integer>
无论右边方法返回什么，都不会崩溃，后续可统一用 isPresent()、ifPresent()、orElse() 等方式安全消费。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
配合链式操作避免空指针
包装后可自然衔接 map、filter、flatMap 等操作，整个链条不暴露 null：
Optional<string> nameUpper = Optional.ofNullable(user).map(User::getName).map(String::toUpperCase);</string>String displayName = Optional.ofNullable(user).map(User::getProfile).map(Profile::getNickname).orElse("游客");
只要中间任意一环为 null，后续 map 不会执行，最终结果就是 empty，不会触发 NPE。
注意：它只解决“包装”问题，不解决源头 null
ofNullable 是防御性封装，不是消除 null 的银弹。它无法让 findUserById 本身不返回 null，也不能替代合理的空值校验或默认值设计。该用 @NonNull 注解、契约文档或提前 fail-fast 的地方，仍需保持警惕。
