Objects.requireNonNull() 是 Java 中最简洁标准的参数非空校验方式,用于方法入口或构造函数中主动抛出 NPE 并附带提示信息,专为入参校验设计,不适用于返回值、局部变量或业务级空值处理。
直接在方法开头用 objects.requirenonnull() 检查参数是否为 null,是 java 中最简洁、标准的非空校验方式。它会在参数为 null 时立即抛出 nullpointerexception,并附带可读性较强的提示信息,避免空指针问题蔓延到后续逻辑中。
基础用法:拦截 null 并抛出默认异常
只需一行代码,就能在方法入口处完成校验:
public void processUser(User user) {
Objects.requireNonNull(user); // 若 user == null,立刻抛出 NPE
// 后续逻辑安全执行,user 必然非 null
System.out.println("Processing: " + user.getName());
}
此时抛出的异常消息为 "Cannot be null"(JDK 19+)或 "null"(旧版本),虽简短但已明确指出问题根源。
增强可读性:自定义异常消息
传入提示字符串,让调用方一眼看懂哪个参数出错:
public void sendEmail(String email, String subject, EmailTemplate template) {
Objects.requireNonNull(email, "email must not be null");
Objects.requireNonNull(subject, "subject must not be null");
Objects.requireNonNull(template, "template must not be null");
// 安全调用 template.render(email, subject)
}
这种写法在团队协作和调试时非常实用,尤其当方法参数较多时,能快速定位问题字段。
立即学习“Java免费学习笔记(深入)”;
配合构造函数:保障对象状态合法性
在不可变类或严格封装的类中,把校验前移到构造阶段,从源头杜绝无效实例:
public final class Order {
private final String orderId;
private final Customer customer;
public Order(String orderId, Customer customer) {
this.orderId = Objects.requireNonNull(orderId, "orderId is required");
this.customer = Objects.requireNonNull(customer, "customer is required");
}
}
这样一旦创建成功,orderId 和 customer 就永远非空,后续所有方法都无需重复校验,逻辑更干净。
注意点:不要用于返回值或内部变量
requireNonNull() 是专为**入参校验**设计的工具,不建议用于:
- 校验方法返回值(应由被调用方负责)
- 校验局部变量或私有字段(通常说明设计有缺陷,比如未初始化)
- 替代业务逻辑中的空值处理(如允许
null表示“无数据”,那就该显式判断而非强制拒绝)
它的核心价值在于“契约式防御”——明确声明“这个参数必须提供”,而不是掩盖或绕过空值问题。


















