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 时显示“匿名用户”：

Massive.com CLI

一款AI数据处理工具，主要用于用于查询 Massive 市场数据端点的 Bash CLI 封装和 OpenClaw 技能，适用于 Codex 或 OpenClaw 代理从 shell 调用，适合需要提升相关任务效率的用户。

下载

• 传统写法（啰嗦且易错）：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，该方法只作用于最内层结果