将可变对象存入 hashset 后修改其参与哈希计算的字段,会导致该对象在集合中的位置与当前哈希表结构不匹配,从而引发查找失败或重复添加等异常行为。要避免这种情况,要么使用不可变对象(如 string、integer),要么在修改对象字段前先从集合中移除该对象,修改完成后再重新添加。

HashSet 如何定位元素
HashSet 基于 HashMap 实现,其核心在于通过对象的 hashCode() 确定桶位,再通过 equals() 确认具体元素。当对象被存入时,JVM 会计算其初始哈希值并放入对应的桶中。如果后续修改了影响哈希值的字段,对象虽然还在原桶中,但其新哈希值可能指向另一个桶,导致 contains() 方法在新桶中找不到它,或者在旧桶中因哈希冲突处理逻辑混乱而表现异常。

import java.util.HashSet;
import java.util.Objects;
public class MutablePerson {
private String name;
private int age;
public MutablePerson(String name, int age) {
this.name = name;
this.age = age;
}
// 修改年龄,这会改变 hashCode()
public void setAge(int age) {
this.age = age;
}
@Override
public int hashCode() {
return Objects.hash(name, age);
}
@Override
public boolean equals(Object obj) {
if (this == obj) return true;
if (!(obj instanceof MutablePerson)) return false;
MutablePerson other = (MutablePerson) obj;
return age == other.age && Objects.equals(name, other.name);
}
@Override
public String toString() {
return "Person{name='" + name + "', age=" + age + "}";
}
public static void main(String[] args) {
HashSet<MutablePerson> set = new HashSet<>();
MutablePerson p = new MutablePerson("Alice", 30);
// 1. 添加对象
set.add(p);
System.out.println("Added: " + p);
System.out.println("Contains Alice(30): " + set.contains(new MutablePerson("Alice", 30)));
// 2. 修改关键字段
p.setAge(31);
System.out.println("Modified to: " + p);
// 3. 尝试查找原始状态的对象
// 由于 p 的 hashCode 已变,set.contains 会在错误的桶中查找
System.out.println("Contains Alice(30) after modify: " + set.contains(new MutablePerson("Alice", 30)));
// 4. 尝试查找修改后的对象
// 虽然 p 在集合里,但它的哈希值变了,contains 可能找不到完全匹配的实例
// 注意:这里 contains 创建了新对象,其哈希值为 31 对应的桶,而 p 实际在 30 的桶里
System.out.println("Contains Alice(31) via new instance: " + set.contains(new MutablePerson("Alice", 31)));
// 5. 直接检查引用是否还在集合中(通常不会直接暴露内部结构,但可以通过迭代器验证)
for (MutablePerson mp : set) {
System.out.println("Found in set: " + mp);
}
}
}
运行上述代码,输出结果如下:
Added: Person{name='Alice', age=30}
Contains Alice(30): true
Modified to: Person{name='Alice', age=31}
Contains Alice(30) after modify: false
Contains Alice(31) via new instance: false
Found in set: Person{name='Alice', age=31}
可以看到,修改后 contains 返回了 false,尽管对象仍然存在于集合中。这是因为 HashSet 无法自动更新已存在元素的哈希位置。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何安全地修改集合中的对象
如果必须修改集合中的可变对象,正确的做法是遵循“先移除、再修改、后添加”的流程。这样可以确保在对象状态改变期间,它不在哈希表的查找路径上,从而避免数据不一致。另一种更安全的策略是使用不可变对象,例如 Java 8 引入的 record 或手动实现 final 字段的类,这样一旦创建就无法修改,从根本上杜绝了此类问题。

import java.util.HashSet;
import java.util.Objects;
public class SafeMutablePerson {
private String name;
private int age;
public SafeMutablePerson(String name, int age) {
this.name = name;
this.age = age;
}
public void setAge(int age) {
this.age = age;
}
@Override
public int hashCode() {
return Objects.hash(name, age);
}
@Override
public boolean equals(Object obj) {
if (this == obj) return true;
if (!(obj instanceof SafeMutablePerson)) return false;
SafeMutablePerson other = (SafeMutablePerson) obj;
return age == other.age && Objects.equals(name, other.name);
}
@Override
public String toString() {
return "Person{name='" + name + "', age=" + age + "}";
}
public static void main(String[] args) {
HashSet<SafeMutablePerson> set = new HashSet<>();
SafeMutablePerson p = new SafeMutablePerson("Bob", 25);
set.add(p);
System.out.println("Initial: " + p + ", Contains: " + set.contains(new SafeMutablePerson("Bob", 25)));
// 安全修改流程
set.remove(p); // 1. 移除
p.setAge(26); // 2. 修改
set.add(p); // 3. 重新添加
System.out.println("After safe modify: " + p + ", Contains: " + set.contains(new SafeMutablePerson("Bob", 26)));
}
}
此示例展示了正确的操作顺序。首先调用 remove(p) 将对象从哈希表中卸载,然后修改其字段,最后再次调用 add(p) 将其以新的哈希值插入到正确的桶中。这样能保证 contains 查询始终正确。
使用 record 作为不可变键的优势
在 Java 16+ 环境中,推荐使用 record 来定义集合中的元素。记录类型默认所有字段为 final,且编译器自动生成 hashCode 和 equals 方法,使得对象一旦创建便不可变。这消除了手动管理移除/添加逻辑的需要,也避免了因意外修改导致的哈希表损坏风险。对于需要频繁作为 HashSet 或 HashMap 键的场景,这是最安全且简洁的选择。

















