重写 equals 和 hashcode 必须同时进行且逻辑一致:若 equals 返回 true,则 hashcode 必须相等,否则在 hashset 或 hashmap 中会导致查找失败、删除失败或重复添加;equals 需满足自反性、对称性、传递性、一致性及对 null 的处理;推荐用 getclass() 判断类型并配合 objects.equals 比较字段;hashcode 应仅基于 equals 中使用的不可变字段,推荐 objects.hash;继承场景下建议类声明为 final 或明确文档约束。

重写 equals 和 hashCode 必须一起做,且逻辑严格一致——只要两个对象 equals 返回 true,它们的 hashCode 就必须相等;否则放入 HashSet 或作为 HashMap 的 key 时会出错:查不到、删不掉、重复添加。
equals 方法要满足五项基本要求
不是“写出来就行”,而是必须符合 Java 规范定义的契约:
-
自反性:任何非 null 对象调用
x.equals(x)必须返回true -
对称性:若
x.equals(y)为true,则y.equals(x)也得是true -
传递性:若
x.equals(y)和y.equals(z)都为true,则x.equals(z)也必须为true - 一致性:只要参与比较的字段没变,多次调用结果不能变
-
对 null 的处理:任何非 null 对象调用
x.equals(null)必须返回false
常见错误是用 instanceof 判断类型——在有继承关系时容易破坏对称性(比如父类实例能 equals 子类实例,但子类实例却不能 equals 父类实例)。稳妥做法是用 getClass() == obj.getClass() 做运行时类型精确匹配。
标准写法模板(推荐用 Objects 工具类)
以一个含 id、name、age 的 Person 类为例:
- 先用
this == obj判断是否同一引用(性能优化) - 再判断
obj == null || getClass() != obj.getClass() - 强制转换后,用
Objects.equals(a, b)比较每个字段(自动处理null) - 数值类型如
int可直接==,但double/float要用Double.compare()避免精度问题
示例:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
if (this == obj) return true;
if (obj == null || getClass() != obj.getClass()) return false;
Person person = (Person) obj;
return age == person.age &&
Objects.equals(id, person.id) &&
Objects.equals(name, person.name);
}
hashCode 必须与 equals 使用相同字段
hashCode 的值只应由 equals 中实际参与比较的字段决定。只要这些字段不变,哈希码就不能变;一旦它们变了,哈希码就必须变。
- 推荐用
Objects.hash(id, name, age),简洁、自动处理null、无需手动乘加 - 绝对不要用可变字段(比如后面可能被修改的集合、时间戳、随机数等),否则对象放进
HashSet后再改字段,就再也找不到了 - 如果类是不可变的(所有字段
final),可考虑在构造时缓存哈希值,提升性能
示例:
public int hashCode() {return Objects.hash(id, name, age);
}
继承场景要格外小心
如果类允许被继承,用 getClass() 会阻止子类实例与父类实例相等(这是设计选择,不是 bug);若需支持“跨类型相等”,就得用 instanceof 并仔细验证对称性和传递性——但多数情况下不建议这么做。更安全的做法是把类声明为 final,或明确文档说明“该类不支持子类参与 equals 比较”。
无论哪种情况,重写后务必用测试覆盖:往 HashSet 里加两个相等对象,确认只存一个;用相等对象做 HashMap 的 key,确认能正确 get 到值。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










