identityhashmap 用对象引用地址而非 equals() 判断键相等，可精准识别同一实例，避免循环引用和共享子图序列化错误；普通 hashmap 因依赖重写的 equals/hashcode，易因逻辑相等覆盖物理不同实例或哈希不稳定导致序列化失败。
IdentityHashMap 用的是对象引用地址（identity）而非 equals() 方法来判断键是否相等，这在需要绕过重写的 equals 或避免哈希码不一致导致的映射失效时非常关键。在自定义序列化钩子（如 writeObject/readObject）中，若需精确跟踪“同一个对象实例”的多次出现（例如循环引用、共享子图），用它能可靠实现对象图遍历去重或唯一标记。
为什么普通 HashMap 在序列化钩子中容易出错
标准 HashMap 依赖 hashCode() 和 equals()。但很多业务类会重写这两个方法以实现逻辑相等语义——这恰恰与序列化所需的“物理同一性”冲突。比如：
- 两个不同实例但字段完全相同的 DTO，
equals()返回true，会被当成同一个键覆盖； - 某些类的
hashCode()实现不稳定（如基于可变字段），导致 put 后 get 不到； - 未重写
hashCode()却重写了equals()，直接违反契约，引发不可预测行为。
在 writeObject 中用 IdentityHashMap 记录已序列化对象
用于检测并处理循环引用：首次遇到某对象时记录其位置或分配唯一 ID；再次遇到时不再递归序列化，而是写入一个“引用标记”。示例片段：
private void writeObject(ObjectOutputStream s) throws IOException {
s.defaultWriteObject();
// 使用 IdentityHashMap 确保按引用判等
IdentityHashMap<object integer> seen = new IdentityHashMap();
List<object> refs = new ArrayList();
serializeTree(this, s, seen, refs);
}
private void serializeTree(Object obj, ObjectOutputStream s,
IdentityHashMap<object integer> seen, List<object> refs) throws IOException {
if (obj == null) {
s.writeByte(0); // null marker
return;
}
Integer id = seen.get(obj);
if (id != null) {
s.writeByte(1); // ref marker
s.writeInt(id);
return;
}
// 首次出现：记录并序列化
int nextId = refs.size();
seen.put(obj, nextId);
refs.add(obj);
s.writeByte(2); // object marker
s.writeObject(obj); // 触发其 own writeObject 或默认机制
// 递归处理 obj 的字段...
}</object></object></object></object>
注意 readObject 中必须配对使用 IdentityHashMap
反序列化时不能只靠 readObject() 返回值做 key——因为刚 new 出来的对象尚未被任何引用持有，IdentityHashMap 查不到。正确做法是预先构建对象占位符（如用 new Object() 或 Unsafe.allocateInstance），存入 map，再填充字段：
- 先读取所有对象结构（含引用 ID），生成空实例列表；
- 用
IdentityHashMap<object integer></object>映射每个空实例到其索引； - 再逐个调用
readObject填充字段，遇到引用 ID 时从列表取对应实例赋值。
替代方案对比：WeakReference + System.identityHashCode？
不推荐。虽然 System.identityHashCode() 接近地址哈希，但它不保证唯一（有碰撞），且无法解决 equals 覆盖带来的键冲突问题。而 WeakReference 引入 GC 不确定性，在序列化这种强一致性场景下风险高。IdentityHashMap 是 JDK 提供的零配置、零歧义、线程不安全但正适合单线程序列化流程的工具。
