Java HashMap 怎么自定义对象作为 Key 并重写哈希-java教程-PHP中文网

必须同时重写hashcode()和equals()，因为hashmap先用hashcode()定位桶，再用equals()比对桶内元素；只重写其一会导致哈希冲突误判或key无法查找。

java hashmap 怎么自定义对象作为 key 并重写哈希

要用自定义对象作为 HashMap 的 key，必须同时重写 hashCode() 和 equals() 方法，否则会出现“找不到 key”或重复插入等问题。

为什么必须重写这两个方法？

HashMap 查找 key 时，先用 hashCode() 定位到桶（bucket），再用 equals() 在该桶中逐个比对。如果只重写其中一个：

只重写 hashCode()：不同对象可能返回相同哈希值，但 equals() 返回 false，导致误判为不同 key，实际应视为相同；
只重写 equals()：对象逻辑相等，但哈希值不同，会被散列到不同桶里，get() 永远找不到它。

如何正确重写 hashCode()？

确保逻辑上相等的对象（equals() 返回 true）必须有相同哈希值。常用写法是基于参与 equals() 判断的字段计算：

// 示例：Person 类

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

@Override
public int hashCode() {
    return Objects.hash(name, age, id);
}

或者手动组合（推荐用 Objects.hash()，简洁且空安全）：

避免使用随机数、时间戳、数据库 ID 等可变值；
不包含可变字段（如未被 final 修饰且后续会修改的属性）；
字段顺序和 equals() 中的判断顺序保持一致。

如何正确重写 equals()？

遵循对称性、传递性、一致性、非空性、自反性五条原则。标准模板如下：

@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    Person person = (Person) o;
    return age == person.age &&
           Objects.equals(name, person.name) &&
           Objects.equals(id, person.id);
}