Objects.requireNonNull()用于主动校验非空参数并抛出带消息的NullPointerException,返回原对象支持链式调用;Objects.equals()安全比较可能为null的对象;Objects.toString()避免null字符串打印;Objects.hash()和deepEquals()对null安全但需注意语义一致性。

Objects.requireNonNull() 是最直接的防御式检查
当方法参数或关键对象不能为 null 时,用 Objects.requireNonNull() 主动抛出 NullPointerException,比让后续代码崩溃更可控。它返回原对象,方便链式调用。
- 常见错误:用
if (obj == null) throw new NullPointerException()手写判断,冗长且易漏掉消息提示 - 正确用法:
String name = Objects.requireNonNull(inputName, "inputName must not be null"),第二个参数是自定义异常消息,强烈建议加上 - 注意:它只做非空断言,不改变对象本身,也不做默认值 fallback
Objects.equals() 安全比较两个可能为空的对象
代替 a.equals(b),避免因 a 为 null 导致 NPE。它内部先判空再调用 equals,语义等价于 a == b || (a != null && a.equals(b))。
- 典型场景:DTO 字段比较、Map 的 key 查找、单元测试中的断言
- 不要用于
==场景:比如Objects.equals(a, b)和a == b行为不同,前者走equals(),后者是引用比较 - 性能影响极小,JVM 对这种静态方法调用优化很好,无需担心
Objects.toString() 避免打印 null 字符串
替代 obj.toString() 或字符串拼接中直接引用对象,防止日志或 UI 显示出现 "null" 文本或触发 NPE。
- 默认行为:
Objects.toString(null)返回"null"(字符串);Objects.toString(obj, "default")可指定空值时的替代字符串 - 常见误用:在日志里写
log.info("user=" + user),若user为null,实际输出"user=null"——这看似无害,但掩盖了本该校验的空值问题 - 更推荐组合使用:
Objects.toString(user, "N/A")明确表达“不可用”,比默认"null"更具业务含义
Objects.hash() 和 Objects.deepEquals() 要小心使用场景
Objects.hash() 用于生成字段组合的哈希值,Objects.deepEquals() 用于递归比较数组或嵌套结构。它们都对 null 安全,但容易被误用。
立即学习“Java免费学习笔记(深入)”;
-
Objects.hash(a, b, c)内部会把null当作 0 处理,所以Objects.hash((String)null)和Objects.hash("")结果不同,但都合法 -
Objects.deepEquals(arr1, arr2)支持null数组,也支持null元素,但仅对数组和实现了deepEquals协议的类(如List)有效;对普通自定义对象仍调用equals() - 陷阱:在重写
hashCode()时用了Objects.hash(field),但没同步更新equals()逻辑,会导致哈希表行为异常——空安全不等于逻辑一致
null(用 requireNonNull),哪些地方该容忍 null(用 equals 或 toString),以及是否所有 null 都代表相同语义。










