不能直接用可变对象作HashMap的key,因为修改字段会导致hashCode变化,使get()查找失败;应使用不可变对象或确保hashCode/equals不依赖可变字段。

不能直接把可变对象当 HashMap 的 key 用,否则改了字段就“找不着”——这不是 bug,是哈希表机制决定的必然结果。
为什么一改字段 key 就“消失”了
HashMap 插入时靠 key.hashCode() 算出桶位置,存进去;查找时再算一次 hashCode() 去同一个桶里用 equals() 匹配。如果字段改了,hashCode() 变了,get() 就会去错的桶里翻,自然返回 null。哪怕 equals() 还能对上,也白搭——压根没走到那一步。
- 比如 new Student("张三", 20) 存进 map,之后调用 student.setAge(25),若 age 参与 hashCode 计算,哈希值就变了
- 此时 map.get(student) 返回 null,即使 student 对象本身没丢,它在 map 里已成“幽灵条目”
- 多线程下更危险:一个线程刚 put,另一个线程立刻改字段,后续所有 get 都失效
快速定位是否发生了哈希漂移
怀疑 key 找不到?别急着重写逻辑,先验证哈希值有没有变:
- 存入前打印 key.hashCode(),比如 182347
- 修改字段后立即再打一次,比如变成 291056
- 两个值不同 → 确认是哈希漂移导致丢失
- 也可用 debugger 观察 map.table[index] 对应桶里是否还有该 Entry(但链表/红黑树里可能已无法命中)
真要用可变对象,必须切断修改与哈希的耦合
不是禁止修改,而是让修改不影响哈希行为。有几种务实做法:
- 只用不可变字段参与 hashCode/equals:比如 Student 类中,仅 id 字段参与计算,name/age 改了也不影响哈希值
- 封装一层不可变包装类:新建 ImmutableStudent,构造时拷贝 id(只读),hashCode/equals 全部基于这个 final id 实现,与原始 Student 解耦
- 运行时防御:在 setter 里加检查,如发现该实例已被注册为 map key,就抛 IllegalArgumentException(适合测试或灰度环境)
- 业务层约定 + 文档约束:明确标注“该对象一旦作为 key,禁止调用 setXXX”,配合 Code Review 卡点
更推荐的替代路径
与其绕弯子防护可变 key,不如从源头规避风险:
- 优先用 JDK 不可变类型:String、Integer、LocalDate、UUID —— 它们天然稳定,不用操心
- 为业务语义定制不可变类:比如 OrderKey(orderId + shopId),全部字段 final,构造即固定,重写 hashCode/equals 仅依赖这两个字段
- 需要“更新 key”时,走显式替换:map.remove(oldKey); map.put(newKey, value),而不是原地改 oldKey
- 避免用 ArrayList、StringBuilder、SimpleEntry 这类明显可变的类作 key,它们连基本契约都不满足










