相等对象必须有相同 hashcode，这是 java 规范的硬性契约；若 hashcode 不同但 equals 返回 true，会导致 hashmap/hashset 查找失败、集合行为异常；常见错误包括只重写 equals 未重写 hashcode、字段不一致、使用可变字段或数组引用哈希；正确做法是 equals 与 hashcode 基于同一组不可变字段，用 objects.equals 和 objects.hash 保持字段顺序一致，并对数组使用 arrays.hashcode。
如果 hashCode 不一致，equals 就不该返回 true —— 这不是“怎么处理”的问题，而是设计错误的信号。
根本原则：相等对象必须有相同 hashCode
Java 规范明确要求：只要 x.equals(y) == true，就必须满足 x.hashCode() == y.hashCode()。这是硬性契约，不是可选优化。
一旦出现 hashCode 不同但 equals 返回 true，说明两个方法没有协同实现，会导致：
- 对象在
HashMap或HashSet中无法被查到（因为先按哈希桶定位，桶都不对，根本不会调用equals） - 集合行为不可预测，比如重复插入、remove 失败、contains 返回 false
- 单元测试可能通过局部逻辑，但在真实集合场景中崩溃
常见导致 hashCode 不一致的错误写法
这些情况会让 equals 和 hashCode “脱节”：
-
只重写了
equals，没重写hashCode：系统默认用 Object.hashCode()（基于内存地址），两个逻辑相等的对象地址不同 → 哈希值必然不同 -
参与
equals的字段和参与hashCode的字段不一致：比如equals比了name和age，但hashCode只用了name -
使用了可变字段且中途修改：对象存入
HashSet后改了参与hashCode的字段 → 哈希值变了，原位置找不到了 -
数组字段直接传给
Objects.hash()：它对数组调用的是引用哈希，而非内容哈希；应改用Arrays.hashCode(arr)
正确做法：保持字段完全对齐
确保 equals 和 hashCode 基于同一组不可变（或稳定）字段计算：
- 在
equals中用Objects.equals(a, b)安全比较每个字段（自动处理 null） - 在
hashCode中用Objects.hash(f1, f2, f3)，参数顺序和字段必须与equals中的判断顺序、范围严格一致 - 若含数组，用
Arrays.hashCode(arr)或Arrays.deepHashCode(arr)替代原始数组参数 - 避免在
hashCode中使用 getter 计算值（除非该值本身是 final 且由构造器确定）
调试建议：快速验证一致性
写完两个方法后，加一个简单断言测试：
// 示例：验证两个相等对象的哈希值一致
Person p1 = new Person("Alice", 30);
Person p2 = new Person("Alice", 30);
assert p1.equals(p2) : "equals failed";
assert p1.hashCode() == p2.hashCode() : "hashCode mismatch";
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
