Java对象基类教程：正确重写equals方法指南

Java中正确重写equals方法远不止简单判断字段相等，而是一场必须严格遵循自反性、对称性、传递性、一致性和null安全五大规范的精密操作——稍有偏差就会导致HashMap丢失数据、HashSet重复插入或集合遍历异常等隐蔽而致命的bug；本文手把手教你用“引用检查→类型与null校验→字段安全比对”三步法写出健壮的equals，并强调必须同步重写hashCode（推荐Objects.hash），同时揭露instanceof误用、null未防护、字段遗漏等高频陷阱，帮你避开90%开发者都踩过的坑。

重写 equals 方法不是简单地加个判断，而是要遵守 Java 规范定义的自反性、对称性、传递性、一致性以及对 null 的处理。不按规则写，可能引发集合操作异常、哈希表错乱甚至逻辑 bug。

为什么不能直接用 == 比较对象？

== 比较的是引用是否指向同一内存地址，而多数场景下我们关心的是“内容是否相等”。比如两个 new Person("张三", 25) 实例，字段完全一样，但 == 返回 false —— 这显然不符合业务直觉。

重写 equals 的标准步骤

以下是一个安全、规范的模板，适用于大多数 POJO 类：

• 第一步：检查是否为同一对象（引用相等） —— 提升性能，且满足自反性：
  if (this == obj) return true;
• 第二步：检查参数是否为 null 或类型不匹配 —— 避免空指针，确保类型安全：
  if (obj == null || getClass() != obj.getClass()) return false;
  注意：用 getClass() 而非 instanceof，防止子类误判破坏对称性（如父类 equals 接受子类，子类 equals 拒绝父类）。
• 第三步：强制类型转换并逐字段比较 —— 基本类型用 ==，引用类型用 Objects.equals(a, b)（自动处理 null）：
  Person other = (Person) obj;
return age == other.age && Objects.equals(name, other.name);

必须同步重写 hashCode

如果重写了 equals 却没重写 hashCode，会导致对象在 HashMap、HashSet 中行为异常：两个逻辑相等的对象可能被散列到不同桶中，造成“找不到”或重复添加。

推荐用 Objects.hash(...) 生成哈希值，字段顺序和 equals 中的比较顺序保持一致：
@Override
public int hashCode() {
  return Objects.hash(name, age);
}

常见错误与规避建议

• 用 instanceof 判断类型：可能导致子类与父类比较时不对称。例如 Student extends Person，若 Person.equals 接受 Student，但 Student.equals 因字段多而拒绝 Person，就违反对称性。
• 忽略 null 安全：手动调用 field.equals() 前未判空，运行时抛 NullPointerException。统一用 Objects.equals(a, b) 更稳妥。
• 字段遗漏或类型不一致：比如只比较了 name 忘了 age；或把 Long id 和 long id 混用，导致 Objects.equals 返回 false（因装箱差异）。

不复杂但容易忽略细节。只要记住：equals 和 hashCode 是一对契约，改一个必改另一个；比较逻辑要严谨，工具类（如 Objects）是你的朋友。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。