若两个对象equals为true,则它们的hashCode必须相等;因此在重写equals时必须同时重写hashCode,以确保对象在HashMap、HashSet等集合中能正确工作。

在Java中,equals 和 hashCode 是两个定义在 Object 类中的方法,它们共同影响对象在集合(尤其是 HashMap、HashSet 等哈希结构)中的行为。正确理解并合理重写这两个方法的关系,对程序的正确性和性能至关重要。
equals 与 hashCode 的契约关系
Java官方明确规定:如果两个对象通过 equals 方法比较返回 true,那么它们的 hashCode 必须相等。反之则不一定成立 —— 即 hashCode 相同,equals 不一定为 true(这就是哈希冲突)。
这个规则出自《Effective Java》,是编写高质量Java类的基础之一。
具体来说,必须遵守以下原则:
立即学习“Java免费学习笔记(深入)”;
- 若 a.equals(b) == true,则 a.hashCode() == b.hashCode()
- 若 a.hashCode() != b.hashCode(),则 a.equals(b) 一定为 false
- 若 a.hashCode() == b.hashCode(),a.equals(b) 可能为 true,也可能为 false
为什么需要同时重写 equals 和 hashCode?
当你使用 HashMap 或 HashSet 存储自定义对象时,系统会先通过 hashCode 找到对应的桶位置,再用 equals 判断是否为同一对象。
如果你只重写了 equals 而没有重写 hashCode,会导致:
- 逻辑上“相等”的对象(equals 返回 true)可能拥有不同的哈希值
- 这些对象会被存入不同的桶中,导致无法通过 get 或 contains 正确查找到
- 例如:把一个 Person 对象作为 key 放入 HashMap,之后用另一个“相同内容”的 Person 去 get,结果返回 null
实际示例说明
假设有一个 Person 类:
EnableCE与众多学术会议管理系统的最大不同,是把会议与论文投稿分离成两个不同的管理对象,这两个对象既可分离自成体系,又可在两者之间建立关联关系,形成统一整体。依据这样的管理理念,EnableCE它可以帮助您轻松管理以下四类会议或活动:学术性会议:参会人员须先提交作者名单中包含其姓名的论文稿件,在稿件被专家审核通过的前提下,方允许其进行会议的注册报名一般性会议:会议不进行论文征文,参会人员可直
private String name;
private int age;
// 只重写了 equals,未重写 hashCode
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (!(o instanceof Person)) return false;
Person person = (Person) o;
return age == person.age && Objects.equals(name, person.name);
}
}
此时虽然两个 name 和 age 相同的 Person 被认为相等,但由于继承自 Object 的 hashCode 是基于内存地址生成的,不同实例的哈希值不同。
执行以下代码可能出现问题:
MapPerson p1 = new Person("Alice", 25);
Person p2 = new Person("Alice", 25);
System.out.println(p1.equals(p2)); // true
map.put(p1, "value");
System.out.println(map.get(p2)); // null(期望是"value")
原因就是 p1 和 p2 的 hashCode 不同,get 时找不到对应桶。
如何正确重写
建议使用 IDE 自动生成或借助工具类(如 Objects.hash)来保持一致性。
@Overridepublic int hashCode() {
return Objects.hash(name, age);
}
这样,只要 name 和 age 相同,hashCode 就相同,满足了与 equals 的契约。
基本上就这些。只要记住:用了 equals 判断业务上的“相等”,就一定要让 hashCode 反映同样的逻辑,尤其是在要把对象放进哈希集合的时候。









