HashSet去重失效的根本原因是对象插入后修改了影响hashCode()或equals()的字段，导致哈希桶定位错误和相等性判断失准；正确做法是使参与计算的字段不可变，或修改前remove再add。
HashSet 去重失效，根本原因在于对象的 hashCode() 和 equals() 在添加后发生了变化，破坏了哈希表的内部契约。一旦对象被加入 HashSet，它的 hash 值就决定了它存放在哪个桶（bucket）里；后续查找、删除、判断是否重复，都依赖这个初始 hash 值和 equals 逻辑。如果属性变更导致 hash 值改变，该对象就“找不到了”——既不在原桶里，新桶里又没有它，等于逻辑上“消失”了。
为什么修改属性会导致去重失效
HashSet 底层是 HashMap（JDK 8+ 是 Node 数组 + 链表/红黑树），元素作为 key 存储。插入时： - 先调用对象的 hashCode() 算出数组下标（桶位置）； - 再在该桶内遍历节点，用 equals() 判断是否已存在相同元素。
若对象插入后修改了影响 hashCode() 或 equals() 的字段（比如用于计算 hash 的 id、name），会出现： - contains() 返回 false：因为现在算出的新 hash 值指向另一个桶，而原桶里旧节点的 equals 可能也不再匹配； - remove() 失败：同理，找不到目标对象； - 重复插入成功：新 hash 值可能落在空桶，或与现有对象 equals 不成立，于是当作新元素加进去。
正确做法：避免在 HashSet 中使用可变对象
最稳妥的方式是让参与 hash 和 equals 计算的字段在对象创建后不可变：
- 用 final 修饰关键字段（如 id、code、name）；
- 构造器一次性初始化，不提供 setter 方法；
- 若必须修改，先 remove() 再 add() 新对象（注意：这要求你还能拿到原对象引用）；
- 对已有集合中的对象做变更时，务必同步更新 HashSet —— 不能只改属性，要先移除再加入。
如果必须用可变对象，怎么补救
补救的前提是你知道哪些对象可能被修改，并能控制修改时机：
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 修改前主动 remove：在改属性前，确保该对象还在集合中，调用 set.remove(obj)；
- 修改后重新 add：属性改完，再 set.add(obj)，让它按新 hash 值重新定位；
- 封装成工具方法，例如：updateInSet(set, obj, () -> obj.setName("new"))，内部自动完成 remove → 修改 → add；
- 极端情况（如无法获取原引用），只能重建整个 HashSet：new HashSet(oldSet)，但要注意这会触发所有对象的重新 hash，且无法解决 equals 逻辑本身已错乱的问题。
检查你的 equals 和 hashCode 是否合规
常见错误会加剧问题：
立即学习“Java免费学习笔记（深入）”；
- 只重写 equals() 没重写 hashCode()；
- hashCode 使用了可变字段，但 equals 没用它（或反过来）；
- hashCode 计算中用了 null 未判空，导致运行时异常；
- 使用 IDE 自动生成时，勾选了不该参与比较的字段（比如 timestamp、status）。
建议：用 Objects.hash(a, b, c) 生成 hashCode，用 Objects.equals(a, b) 实现 equals，且保证两者使用的字段完全一致、均为 final 或逻辑上不变。
