Objects.requireNonNull是JDK 7引入的空值校验工具，用于在源头快速失败并明确报错，适用于构造器参数、public方法入参及外部关键对象等场景，提升调试效率与代码健壮性。
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+）：
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
立即学习“Java免费学习笔记（深入）”；
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”的最自然方式。
