使用Objects.requireNonNull可有效校验参数非空，防止空指针异常。1. 用于方法入口校验，传入null时抛出带提示信息的NullPointerException；2. 在构造函数中确保关键字段不为null，保障对象状态合法；3. 提供清晰异常消息提升调试效率，建议结合字段名明确错误来源；4. 与Optional配合时，应先用requireNonNull再调用Optional.of()，避免直接传null引发异常。该方法使代码更健壮、意图更清晰，尤其适用于公共API和服务层，体现“尽早失败”设计原则。
在Java开发中，确保方法参数的有效性是编写健壮代码的重要一环。Objects.requireNonNull 是 Java 7 引入的一个便捷工具方法，用于快速校验对象是否为 null，若为 null 则立即抛出 NullPointerException，避免后续执行中出现难以排查的空指针异常。
使用 requireNonNull 进行基础参数校验
该方法最常见用途是在方法入口处校验传入参数是否为空。它接受一个对象引用，如果为 null，就抛出异常；否则返回原对象，便于链式调用或赋值。
public void setUserProfile(User user) {
this.user = Objects.requireNonNull(user, "用户信息不能为空");
}
上面代码中，如果传入的 user 为 null，会立即抛出带有指定提示信息的 NullPointerException。这种写法简洁明了，比手动 if 判断更优雅。
配合构造函数确保对象初始化完整
在构造对象时，关键字段通常不允许为 null。使用 requireNonNull 可以在构造阶段就拦截非法状态。
立即学习“Java免费学习笔记（深入）”；
public class Order {
private final String orderId;
private final String customerName;
public Order(String orderId, String customerName) {
this.orderId = Objects.requireNonNull(orderId, "订单ID不可为空");
this.customerName = Objects.requireNonNull(customerName, "客户姓名不可为空");
}
}
这样能保证创建的 Order 实例内部状态合法，防止后续业务逻辑因字段缺失而出错。
自定义异常消息提升可读性
第二个参数允许传入描述性更强的错误信息，有助于调试和日志记录。建议使用具体、清晰的提示语，而不是笼统的“参数错误”。
- 使用有意义的字段名提示问题来源
- 避免使用模糊词汇如“无效参数”
- 可结合变量名动态生成提示（需注意性能）
public void processPayment(String paymentId, BigDecimal amount) {
Objects.requireNonNull(paymentId, "支付ID不能为空");
Objects.requireNonNull(amount, "支付金额不能为null");
if (amount.compareTo(BigDecimal.ZERO) < 0) {
throw new IllegalArgumentException("支付金额不能为负数");
}
}
与 Optional 结合使用场景
虽然 requireNonNull 主要用于强制非空校验，但在与 Optional 配合时也需注意：Optional 容器本身不应包含 null 值，也不推荐将 null 传递给 Optional.of()。
// 正确做法：自动校验 Optional<String> opt = Optional.of(Objects.requireNonNull(str)); // 错误示范：可能引发异常且冗余 Optional<String> wrong = Optional.of(str); // 若 str 为 null，直接抛异常
若希望容忍 null 值，应使用 Optional.ofNullable()，此时无需提前校验。
基本上就这些。合理使用 Objects.requireNonNull 能让代码更安全、意图更明确，尤其是在公共 API 或服务层中，尽早失败是一种良好的设计习惯。注意搭配清晰的提示信息，能显著提升维护效率。
