必须重写hashcode()，因为java规范要求equals()为true时hashcode()必须相同，否则hashmap、hashset等容器会因散列到不同桶而无法找到对象；核心是参与equals比较的字段必须全部用于hashcode计算。

因为 Java 规范明确要求：如果两个对象 equals() 返回 true，那么它们的 hashCode() 必须返回相同值。这不是编码习惯，而是哈希容器（如 HashMap、HashSet）正常工作的底层契约。

哈希容器靠 hashCode 定位，再用 equals 确认

当对象作为 key 存入 HashMap 或加入 HashSet 时：

• JVM 先调用 hashCode()，算出它该放进哪个“桶”（数组索引）
• 只在那个桶里，才逐个调用 equals() 判断是否真正相等
• 如果 hashCode() 没重写，两个逻辑相等的对象可能散列到不同桶中——后续 get() 或 contains() 就永远找不到对方

不重写 hashCode 的典型故障现象

这些不是编译错误，而是运行时静默失效：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• HashSet.add(a) 和 add(b) 都成功，即使 a.equals(b) == true → 集合重复存入
• map.put(key1, value) 成功，但 map.get(key2) 返回 null，尽管 key1.equals(key2)
• new HashSet(list) 去重失败，而 list.stream().distinct() 却正常

怎么写才算合格

核心原则只有一条：参与 equals 比较的字段，必须全部参与 hashCode 计算。

• 推荐用 Objects.hash(f1, f2, f3)，自动处理 null 和类型转换
• 避免使用可变字段（比如后期会修改的 status 字段），否则对象入集合后再改字段，哈希值变化 → 永远取不出来
• 如果 equals() 只比 id，hashCode() 就只用 id；如果还加了 name 和 email，哈希计算也得包含这三个

继承场景下容易被忽略的一点

子类重写 equals() 时，若引入新字段，不仅自己要重写 hashCode()，还要确保父类的 hashCode() 已正确实现。否则父子对象之间可能违反对称性或一致性契约。