重写equals和hashcode是为了确保集合框架行为可预测、结果可复现;必须遵守“相等对象哈希码相同”契约,equals需满足自反性、对称性、传递性、一致性和非空性五项约定,且二者字段参与必须完全一致。

重写 equals 和 hashCode 不是为了“让对象看起来相等”,而是为了在 Java 集合框架中**行为可预测、结果可复现**。核心在于严格遵守两者之间的契约:相等的对象必须有相同的哈希码;哈希码相同不意味着一定相等,但哈希码不同则一定不相等。
equals 方法必须满足的五项基本约定
Java 规范强制要求重写的 equals 方法必须同时满足以下五点,否则集合类(如 HashSet、HashMap)行为将不可靠:
-
自反性:对任意非 null 对象
x,x.equals(x)必须返回true -
对称性:对任意非 null 对象
x和y,x.equals(y)为true当且仅当y.equals(x)也为true -
传递性:若
x.equals(y)且y.equals(z)为true,则x.equals(z)也必须为true -
一致性:只要参与比较的字段未被修改,多次调用
x.equals(y)应始终返回相同结果 -
非空性:对任意非 null 对象
x,x.equals(null)必须返回false
重写 equals 的标准步骤(含 null 安全)
以 Person 类为例,关键字段为 name(String)和 age(int):
- 先用
this == obj判断是否为同一引用,是则直接返回true - 再检查
obj == null或getClass() != obj.getClass(),任一成立即返回false(注意:不用instanceof防止子类破坏对称性) - 安全向下转型:
Person other = (Person) obj - 逐字段比较:数值类型用
==,引用类型(如String)用Objects.equals(a, b)(自动处理 null)
示例代码片段:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
@Override
public boolean equals(Object obj) {
if (this == obj) return true;
if (obj == null || getClass() != obj.getClass()) return false;
Person person = (Person) obj;
return age == person.age && Objects.equals(name, person.name);
}hashCode 必须与 equals 保持逻辑一致
只要 equals 中用于判断相等的字段发生了变化,hashCode 就必须基于这些字段重新计算。常见错误是只用部分字段或漏掉 null 判断。
- 推荐使用
Objects.hash(...):自动处理 null,简洁可靠,例如return Objects.hash(name, age); - 手动计算时,常用质数 31 作为乘数:先初始化
result = name != null ? name.hashCode() : 0,再result = 31 * result + age - 确保所有参与
equals比较的字段,都参与hashCode计算——一个都不能少,也不能多
为什么不能只重写 equals 而不碰 hashCode?
因为默认的 hashCode() 返回的是对象内存地址的映射值。两个内容完全相同但不同实例的对象,equals 返回 true,而默认 hashCode 却返回不同整数,直接违反契约第一条规定。
后果立竿见影:
- 放入
HashSet后,contains()查不到本该存在的对象 - 作为
HashMap的 key,get()永远返回null,即使键内容完全匹配 - 问题隐蔽,调试困难——集合内部先按哈希码分桶,再在桶内用
equals查找;哈希码错,连桶都进错了
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










