Java必看之如何正确重写hashCode()和equals()方法

一、先记住 4 条黄金规范（必须遵守）

1. 两个对象 equals 为 true → hashCode 必须相同——这是铁律，违背了就直接出 Bug。
2. hashCode 相同 → equals 不一定为 true（哈希冲突是允许的，但你要心里有数）。
3. 参与 equals 比较的属性，必须全部参与 hashCode 计算——少一个，去重就不可靠。
4. 只要对象内容没变，hashCode 必须始终返回相同值——可变字段要小心，一旦变了就找不到了。

不遵守？HashSet/HashMap 就会把两个明明相等的对象当成不同元素，去重失败，内存里存一堆重复数据，排查起来非常痛苦。

二、最推荐写法（Objects 工具类，JDK 7+）

1. 通用模板（直接复制改属性名即可）

下面这个模板是业界最推荐的写法，用 JDK 7 引入的 Objects.equals 和 Objects.hash，简洁又安全。你只需要把类名和属性名改成自己的，剩下的交给编译器。

import ja va.util.Objects;

public class 类名 {
    // 你的成员变量
    private 类型 属性1;
    private 类型 属性2;

    // ======================== 重写开始 ========================
    @Override
    public boolean equals(Object o) {
        // 1. 同一个对象，直接返回 true
        if (this == o) return true;
        
        // 2. 为null 或 类型不同，返回 false
        if (o == null || getClass() != o.getClass()) return false;
        
        // 3. 强制类型转换
        类名 其他对象 = (类名) o;
        
        // 4. 比较【所有关键业务属性】（决定是否重复的字段）
        return Objects.equals(属性1, 其他对象.属性1)
            && Objects.equals(属性2, 其他对象.属性2);
    }

    @Override
    public int hashCode() {
        // 必须和 equals 里的属性完全一致！！！
        return Objects.hash(属性1, 属性2);
    }
    // ======================== 重写结束 ========================
}

三、完整实战示例（最常用）

拿一个 User 对象来演示，根据 id + username 去重，age 字段不参与业务唯一性判断：

import ja va.util.Objects;

public class User {
    private Long id;
    private String username;
    private Integer age; // 假设 age 不参与去重

    // 构造、get、set 省略...

    // ===================== 核心重写 =====================
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        // 判断类型安全
        if (o == null || getClass() != o.getClass()) return false;
        
        User user = (User) o;
        // 只比较【业务唯一】的字段：id + username
        return Objects.equals(id, user.id) 
                && Objects.equals(username, user.username);
    }

    @Override
    public int hashCode() {
        // 必须和 equals 完全一致！！！
        return Objects.hash(id, username);
    }
}

效果

• new User(1, "张三", 20)
• new User(1, "张三", 30)

这两个对象虽然 age 不同，但 id 和 username 一样，放入 HashSet 后会被判定为重复元素，成功去重。这正是我们想要的效果。

四、为什么不能用 IDE 自动生成？（可以用，但要懂）

其实 IntelliJ IDEA 和 Eclipse 都能一键生成，完全可以用！

生成快捷键：

• Windows：Alt + Insert
• Mac：Cmd + N

选择 equals() and hashCode() → 勾选参与去重的字段 → 自动生成。生成的代码和上面给的模板完全一致，非常标准。所以不用纠结要不要自己手写，直接用 IDE 生成，但一定要搞懂背后的原理——否则哪天字段变了，你可能忘记同步更新两个方法。

五、最常见的 3 个错误（一定要避开）

错误 1：equals 和 hashCode 使用的属性不一致

// ❌ 错误示范
equals 用 id
hashCode 用 username 
→ 去重失效！

这是最隐蔽的错误，两个方法各自为政，导致 HashSet 在判断时 hashCode 不同直接跳过 equals，明明相等的对象插入了两次。

错误 2：只重写 equals，不重写 hashCode

// ❌ 致命错误
// HashSet 会先判断 hashCode，不同就直接插入，根本不会走 equals！

这个错误太经典了，很多人只记得重写 equals，却忘了 hashCode。结果 HashSet 永远无法去重，因为默认的 hashCode 是根据内存地址计算的，不同对象肯定不同。

错误 3：使用可变值参与 hashCode

比如用一个会被修改的字段（比如 name 后来被改了）来计算 hashCode。对象存入集合后，字段变了，hashCode 也变了，再想根据这个对象查找时，哈希表已经找不到原来的位置了。这会导致元素丢失、缓存失效等一系列诡异问题。

六、一句话总结（面试必背）

1. equals 决定两个对象是否“内容相等”——业务上的相等。
2. hashCode 决定对象在哈希表中的存储位置——查找效率的基石。
3. HashSet 去重规则：hashCode 相同 + equals 为 true——两者缺一不可。
4. 重写原则：参与 equals 的属性，必须全部参与 hashCode——保持一致，才能保证正确性。