Objects.requireNonNull用于主动拦截null实现“提前失败”,应在构造函数和setter中校验;Objects.equals安全处理null比较;Objects.hash和toString简化null字段处理;deepEquals仅对数组递归,非通用深比较。

Objects.requireNonNull 用来主动拦截 null,而不是被动等 NPE
Java 的空指针异常(NullPointerException)往往在深层调用中才暴露,堆栈难读、定位成本高。而 Objects.requireNonNull 的核心价值是「提前失败」:在参数入口处就校验,让问题出现在调用方代码行,而非某个内部方法深处。
常见误用是只在 public 方法里加校验,却忽略构造函数或 setter 中的字段赋值场景:
public class User {
private final String name;
public User(String name) {
this.name = Objects.requireNonNull(name, "name must not be null"); // ✅ 构造时就堵住 null
}
}
- 第二个参数(message)建议写具体字段名,避免泛泛写
"argument is null" - 若需返回默认值而非抛异常,用
Objects.requireNonNullElse,但注意它不校验默认值本身是否为 null - 对集合/数组元素判空?
Objects.requireNonNull不适用——它只检查引用本身,不递归检查内容
Objects.equals 比 == 和 obj.equals 安全得多
手写 a != null && a.equals(b) 容易漏掉 b 为 null 的情况,而 Objects.equals(a, b) 内部已处理所有 null 组合:两个都为 null → true;一个为 null → false;都不为 null → 调用 a.equals(b)。
典型踩坑场景:
立即学习“Java免费学习笔记(深入)”;
- 重写
equals时忘了处理null参数(如直接写other.field.equals(this.field)),导致自身逻辑抛 NPE - 在 Map 的 key 或 Set 元素比较中,用
==比较字符串字面量和用户输入("admin" == inputRole),结果永远 false -
Objects.equals不替代语义相等判断——比如两个 BigDecimal 值相同但精度不同,equals返回 false,这是正确行为
Objects.hash 和 Objects.toString 处理 null 字段更省心
手写 hashCode 时,对可能为 null 的字段要逐个判空再调用 Objects.hashCode(field),否则 field.hashCode() 直接炸;同理,拼接字符串日志时,field.toString() 也会 NPE。
Objects.hash(a, b, c) 和 Objects.toString(obj, "null") 就是为此设计:
public int hashCode() {
return Objects.hash(id, name, email); // 任一为 null 都不会抛异常
}
public String toString() {
return "User{" +
"id=" + id +
", name=" + Objects.toString(name, "'unknown'") + // name 为 null 时显示 'unknown'
'}';
}
-
Objects.hash底层调用的是Arrays.hashCode(Object[]),所以传入 null 是安全的 -
Objects.toString(obj, null)第二个参数为 null 时,返回字符串"null"(不是字面量 null),这点容易误解 - 性能上无明显损耗,但别在高频循环里反复调用——毕竟每次都要装箱、判空、跳转
Objects.deepEquals 不等于深度遍历,它只处理数组
名字带 “deep”,但 Objects.deepEquals(a, b) 实际只对数组类型做递归比较(int[]、String[]、甚至嵌套数组),对普通对象仍调用其 equals 方法。它不递归比较对象字段,也不是 JSON 式深比较工具。
常见错误理解:
- 以为能比较两个含 null 字段的 DTO 实例是否“内容一致”——不能,它和
Objects.equals在非数组场景行为完全一样 - 用它比对 List 或 Map:无效,因为 List 本身不是数组,
deepEquals会退化为调用list1.equals(list2) - 真需要对象深比较?考虑
org.apache.commons.lang3.builder.EqualsBuilder.reflectionEquals或手动实现,别被名字误导
Objects 工具,而是清楚每个方法的边界:它在哪止步,哪部分还得你亲手兜底。










