Java空值检查：Objects.requireNonNull使用方法

Java中空指针异常频发且难以调试，而JDK 7引入的Objects.requireNonNull正是应对这一痛点的轻量级利器——它不试图“防止”空值，却能在问题源头立即失败、精准报错，以极简语义（如“repo must not be null”）清晰表达设计契约；无论是构造器参数校验、public方法入参约束，还是外部关键对象验证，它都以一行代码替代冗长判空逻辑，显著提升代码健壮性、可读性与团队协作效率，是现代Java开发中不可或缺的空值防御实践。

Java中空指针异常（NullPointerException）是最常见的运行时错误之一，而 Objects.requireNonNull 是 JDK 7 引入的轻量、语义清晰的空值校验工具。它不能“防止”空指针发生，但能**在问题源头快速失败、明确报错**，大幅提升调试效率和代码健壮性。

什么时候该用 requireNonNull

适用于方法入参、构造函数参数、关键配置对象等业务逻辑依赖非 null 值的场景。不是所有变量都要检查，重点是那些一旦为 null 就会导致后续逻辑崩溃或语义错误的位置。

• 构造器中校验不可变字段：避免对象创建后就处于非法状态
• public 方法参数：向调用方明确契约，“这个参数必须给”
• 从外部系统（如 JSON 解析、数据库查询）获取的关键对象，且业务上不允许为空

基础用法与常见写法

最简形式会抛出默认的 NullPointerException，消息为 "null"；推荐始终传入自定义提示，便于定位：

public UserService(UserRepository repo, EmailService emailService) {
    this.repo = Objects.requireNonNull(repo, "repo must not be null");
    this.emailService = Objects.requireNonNull(emailService, "emailService must not be null");
}

也可配合方法引用或 lambda 做更灵活的判断（JDK 9+）：

String name = Objects.requireNonNullElse(user.getName(), "anonymous"); // 提供默认值
User user = Objects.requireNonNull(user, () -> "User not found for id: " + userId); // 延迟计算消息

和 if (obj == null) throw 的区别

二者效果相似，但 requireNonNull 更简洁、意图更明确：

• 减少样板代码：一行替代三行（判空 + 抛异常 + 消息拼接）
• 统一风格：团队内空检逻辑一致，降低阅读成本
• 支持静态分析：部分 IDE 和检查工具（如 SpotBugs）能识别并建议补全
• 可读性更强：“requireNonNull”比“if == null”更直白表达设计契约

注意事项与边界情况

它只是校验工具，不解决空值来源问题：

• 不要在性能敏感的循环内部频繁调用（开销虽小，但可避免）
• 对 Optional 类型不适用——Optional 本身就是为了表达“可能为空”，应通过 isPresent() 或 orElse() 处理
• 集合类建议用 Collections.unmodifiableList + requireNonNull 组合，而非只校验集合引用本身
• 注意泛型擦除：对泛型类型参数的空检查仍有效，但无法校验泛型元素是否为 null

空值检查不是越多越好，而是要在关键路径上做精准防御。requireNonNull 是你声明“这里绝不接受 null”的最自然方式。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java空值检查：Objects.requireNonNull使用方法》文章吧，也可关注golang学习网公众号了解相关技术文章。