Java equals 和 hashCode 只重写一个导致 HashSet/HashMap 行为异常怎么办？

Question

仓乃文 · Accepted Answer

Java 规范要求 equals 和 hashCode 必须同时重写且保持一致：equals 相等的对象 hashCode 必须相等。只重写 equals 不重写 hashCode，两个逻辑相等的对象可能落在 HashMap 不同的桶里，导致 contains() 返回 false、put 重复 key 等诡异行为。问题复现： ```java public class User { private String name; private int age; @Override public boolean equals(Object o) { if (this == o) return true; if (!(o instanceof User)) return false; User user = (User) o; return age == user.age && Objects.equals(name, user.name); } // 没有重写 hashCode！ } Set set = new HashSet<>(); set.add(new User("Tom", 20)); set.add(new User("Tom", 20)); System.out.println(set.size()); // 2！应该是 1 // 因为两个 User 的 hashCode 不同，落在不同桶，equals 没机会比较 ``` 正确做法： ```java @Override public int hashCode() { return Objects.hash(name, age); } // 或者 IDE 自动生成（推荐） // IntelliJ: Cmd+N → equals() and hashCode() // Lombok: @EqualsAndHashCode ``` 补充说明： - Objects.hash() 内部用 Arrays.hashCode，对基本类型和引用类型都安全 - Lombok 的 @EqualsAndHashCode 可以自动生成，但注意不要和 @Data 一起用在继承场景 - hashCode 计算中用到的字段必须和 equals 一致，不能多也不能少 - 规则：重写 equals 必须同时重写 hashCode，这是 Java 的铁律 - record 类型（Java 14+）自动生成 equals 和 hashCode，推荐使用