java中equals方法不能单独保证集合元素唯一性,必须与hashcode协同工作;若仅重写equals而不重写hashcode,或两者未用相同字段计算,会导致哈希集合去重失效。

Java 中 equals 方法本身**不直接保证**集合元素唯一性,它必须和 hashCode 协同工作,才能让 HashSet、HashMap 等哈希集合正确识别“重复”。单独重写 equals 而不重写 hashCode,几乎必然导致去重失效。
为什么 equals 单独起不了作用
HashSet 底层用 HashMap 存储,添加元素时流程是:
- 先调用对象的
hashCode(),算出它该放在哪个“桶”(数组索引)里 - 如果那个桶是空的,直接放进去
- 如果桶里已有元素,才逐个调用
existing.equals(newElement)做精确比对
也就是说:hashCode 是快速分流,equals 是最后确认。如果两个逻辑相等的对象 hashCode 不同,它们根本不会进同一个桶,equals 根本没机会被调用——结果就是“明明相等,却存了两份”。
equals 必须满足五项契约
即使 hashCode 正确,equals 实现错误也会让集合行为异常。它必须严格遵守:
-
自反性:自己等于自己(
x.equals(x) == true) - 对称性:A 等于 B,B 就必须等于 A
- 传递性:A=B 且 B=C,则 A=C
- 一致性:只要比较字段不变,多次调用结果不能变
-
对 null 安全:任何对象调用
.equals(null)都必须返回false,不能抛空指针
典型安全写法:先判 this == obj,再判 obj == null || getClass() != obj.getClass(),最后用 Objects.equals(a, b) 比字段。
equals 和 hashCode 必须用同一组字段
比如你希望按 name 和 age 判定两个 Person 是否相同:
-
equals里必须同时比较name和age -
hashCode也必须用name和age一起计算,例如Objects.hash(name, age)
漏掉任一字段,或在 hashCode 里用了 id(但 equals 没比),都会破坏契约,导致集合误判。
字段修改后对象可能“丢失”
一旦对象加入 HashSet,就不该再修改参与 equals 和 hashCode 的字段。
- 因为插入时它被放在了某个桶里,位置由当时的
hashCode决定 - 改完字段后
hashCode变了,但集合不会自动把它挪到新桶 - 后续
contains()或remove()会去新哈希值对应的桶找,找不到——对象就“消失”了
所以推荐把用于判重的字段设为 final,或整个类设计为不可变。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











