Objects.requireNonNullElse() 是 Java 9 引入的非空断言+默认值兜底方法,要求 obj 为 null 时返回非 null 的 defaultObj,否则抛 NPE;适用于轻量、确定、非 null 的默认值场景。

Objects.requireNonNullElse() 是 Java 9 引入的工具方法,专为“非空断言 + 默认值兜底”场景设计,能用一行代码安全替换 null 值,同时避免 NPE 并明确表达业务意图。
核心用法:一行完成判空 + 非空断言 + 默认值返回
该方法签名是:public static <t> T requireNonNullElse(T obj, T defaultObj)</t>。它会先检查 obj 是否为 null —— 如果不为 null,直接返回;如果为 null,则返回 defaultObj,但**前提是 defaultObj 自身也不能为 null**(否则抛出 NullPointerException)。
- ✅ 安全:不会静默接受 null 默认值,强制你提供一个真正可用的备选
- ✅ 清晰:语义明确——“我要一个非 null 的值,没有就用这个(也必须是非 null 的)”
- ❌ 不适用于默认值本身可能为 null 的场景(此时应改用
Objects.requireNonNullElseGet())
典型使用场景与写法对比
比如处理用户姓名字段,希望 null 时显示“匿名用户”:
- 传统写法(啰嗦且易错):
String name = user.getName() != null ? user.getName() : "匿名用户"; - Stream 风格(需额外 map):
Optional.ofNullable(user.getName()).orElse("匿名用户") - 优雅单行(推荐):
String name = Objects.requireNonNullElse(user.getName(), "匿名用户");
注意:“匿名用户”是字面量字符串,天然非 null,完全符合要求。
与 requireNonNullElseGet() 的关键区别
当你的默认值需要动态计算(比如调用方法、查数据库、生成时间戳),且该计算过程**可能耗时或有副作用**,就该用 requireNonNullElseGet():
-
requireNonNullElse(name, computeDefault())—— 无论name是否为 null,computeDefault()都会执行 -
requireNonNullElseGet(name, () -> computeDefault())—— 仅当name为 null 时才执行 lambda
所以“单行默认值优雅替换”的前提,是你提供的默认值是轻量、确定、非 null 的常量或简单表达式。
实用建议与避坑点
- 确保第二个参数(默认值)在编译期或运行期**绝对不为 null**,否则会立即抛 NPE
- 不要传
null字面量或可能为 null 的变量作默认值,例如Objects.requireNonNullElse(str, null)是非法的 - 配合泛型推断使用更简洁,如
Integer code = Objects.requireNonNullElse(httpResponse.getCode(), 500); - 若需链式调用(如
user.getAddress().getCity()),仍需先保证中间对象非 null,该方法只作用于最内层结果

















