必须同时重写hashcode()和equals()，因为hashmap先用hashcode()定位桶，再用equals()精确匹配；二者字段需一致、空值安全、基于不可变字段，否则导致查找失败或性能下降。
在 Java 中，只有当你自定义类作为 HashMap 的 key 时，才需要重写 hashCode() 和 equals()。HashMap 本身不需要你去重写这两个方法——它已经由 JDK 实现好了。关键在于：如果你用自己写的类（比如 Person、Order）做 key，就必须保证这两个方法逻辑一致，否则 HashMap 会“找不到”本该存在的键。
为什么必须同时重写 hashCode 和 equals？
HashMap 查找 key 分两步：
- 先用
hashCode()算出哈希值，定位到某个桶（bucket）； - 再在该桶里用
equals()逐个比较对象是否真正相等。
如果只重写 equals() 不重写 hashCode()，相同逻辑的对象可能被散列到不同桶里，导致 get() 返回 null；反之，如果只重写 hashCode()，不同对象哈希值一样但 equals() 返回 false，虽不影响正确性，但会降低性能（哈希冲突变多）。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
怎么写才安全？推荐用 IDE 自动生成
手写容易出错，建议用 IntelliJ IDEA 或 Eclipse 自动生成：
- 右键 → Generate → 选 hashCode() and equals()；
- 勾选你希望参与比较的字段（比如
id和name）； - 生成后检查：两个方法用的字段必须完全一致。
示例（基于 Person 类）：
public class Person {
private String id;
private String name;
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
Person person = (Person) o;
return Objects.equals(id, person.id) &&
Objects.equals(name, person.name);
}
@Override
public int hashCode() {
return Objects.hash(id, name);
}
}
几个关键细节不能漏
-
空值安全：用
Objects.equals(a, b)替代a.equals(b)，避免 NPE； -
字段一致性：
hashCode()和equals()必须基于同一组非可变字段（最好用 final 字段）； -
不要用可变字段：如果 key 对象的字段在放入 HashMap 后被修改，且该字段参与了
hashCode()，会导致无法再get()到它（因为桶位置变了）； -
遵守约定：若
a.equals(b)为 true，则a.hashCode() == b.hashCode()必须为 true。
验证是否写对了？简单测一下
写完别急着用，加个单元测试快速验证：
@Test
public void testEqualsAndHashCode() {
Person p1 = new Person("001", "Alice");
Person p2 = new Person("001", "Alice");
Person p3 = new Person("002", "Bob");
// equals 对称、自反、传递
assertTrue(p1.equals(p2));
assertFalse(p1.equals(p3));
// hashCode 一致
assertEquals(p1.hashCode(), p2.hashCode());
assertNotEquals(p1.hashCode(), p3.hashCode());
// 放进 HashMap 能正常取出来
Map<person string> map = new HashMap();
map.put(p1, "data1");
assertEquals("data1", map.get(p2)); // 应该命中
}
</person>
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
