HashSet存储自定义对象重复失效的根本原因是未同时重写hashCode()和equals()方法：默认实现基于内存地址，导致逻辑相等的对象被视作不同；必须确保equals为true时hashCode值相同，且参与比较的字段一致。
Java 中 HashSet 存储自定义对象时重复失效，根本原因不是 HashSet 本身有问题，而是对象没告诉它“怎么算相等”。关键在于：必须同时、正确重写 hashCode() 和 equals() 方法。
为什么只靠默认行为会失效
默认的 hashCode() 返回的是对象内存地址的整数表示，equals() 比较的是引用是否指向同一块内存。所以即使两个 Person 对象名字年龄完全一样，只要 new 了两次，它们就是“不同对象”——HashSet 看不到逻辑上的相同，自然不合并。
常见错误包括：
- 完全没重写这两个方法
- 只重写了 equals()，没重写 hashCode() → 哈希桶位置乱，equals 根本没机会被调用
- 重写时用了可变字段（比如 age），之后修改了 age，但对象还在 HashSet 里 → 哈希值变了，原位置找不到它，也新位置查不到它，变成“幽灵元素”
怎么正确重写 hashCode 和 equals
核心是保持一致性：如果 equals 返回 true，hashCode 必须返回相同值；参与 equals 判断的字段，必须也参与 hashCode 计算。
立即学习“Java免费学习笔记（深入）”；
推荐做法：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 用 IDE（如 IntelliJ）自动生成：右键 → Generate → equals() and hashCode()，勾选决定相等性的字段（比如 id、name、email）
- 避免使用可变字段（如 status、lastLoginTime），除非你确定加入集合后绝不修改
- 字段为 null 时，用 Objects.equals() 和 Objects.hash() 处理，安全又简洁
示例（精简版）：
public class User {private String id;
private String name;
// 构造、getter 略
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
User user = (User) o;
return Objects.equals(id, user.id) && Objects.equals(name, user.name);
}
@Override
public int hashCode() {
return Objects.hash(id, name);
}
}
修改对象字段时要特别小心
一旦对象已加入 HashSet，再改影响 equals/hashCode 的字段，会导致集合内部索引错乱。它可能既查不到、也删不掉、还允许重复添加。
安全做法只有两种：
- 把字段设计成 final（如 id、name），从源头杜绝修改
- 必须修改时，先 remove() 再 set 字段，最后 add() 回去
验证是否生效的小技巧
写个简单测试，别只看 size：
- 创建两个内容相同的对象，add 两次，检查 size 是否为 1
- 用 contains() 查第二个对象，应返回 true
- 打印 set 内容，确认没有重复项
如果这些都通过，说明重写到位；否则回头检查字段选择和生成逻辑。
