putAll() 仅复制键值对的引用而非对象本身，当嵌套 Map 存在时，修改副本会意外影响原始 Map；本文通过分析问题代码、揭示浅拷贝本质，并提供基于序列化的可靠深拷贝实现。
java 中 `putall()` 无法实现深拷贝：原因与正确解决方案详解
在敏感词过滤等场景中，常需对嵌套的 HashMap 结构进行安全遍历与临时修改。但如示例所示，使用 putAll() 构建“副本”后修改 futureMap，竟导致原始 map1 被意外污染——这并非 bug，而是 Java 引用语义下浅拷贝的必然结果。
? 问题根源：putAll() 是浅拷贝，不是深拷贝
HashMap.putAll(Map) 仅将源 Map 中每个键值对的引用复制到目标 Map 中。对于值为 HashMap<String, Object> 的条目（如 map2.put("x", map3)），putAll() 复制的是 map3 这个对象的引用，而非创建 map3 的新实例。因此：
tempMap.putAll((HashMap<String, Object>) map.get(key)); // ← 此处 tempMap 和 map3 指向同一内存地址
后续执行 futureMap.remove("isEnd") 实际操作的是原始 map3，从而改变 map1 → map2 → map3 链中的底层数据。
✅ 正确方案：使用序列化实现真正深拷贝
要彻底隔离副本与原结构，必须递归克隆所有嵌套对象。JDK 原生支持的可靠方式是 对象序列化（Serialization） ——前提是所有嵌套类型均实现 Serializable（HashMap 和基本包装类默认满足）：
立即学习“Java免费学习笔记（深入）”；
import java.io.*;
public static HashMap<String, Object> deepCopy(HashMap<String, Object> original)
throws IOException, ClassNotFoundException {
ByteArrayOutputStream bos = new ByteArrayOutputStream();
ObjectOutputStream oos = new ObjectOutputStream(bos);
oos.writeObject(original);
oos.close();
ByteArrayInputStream bis = new ByteArrayInputStream(bos.toByteArray());
ObjectInputStream ois = new ObjectInputStream(bis);
@SuppressWarnings("unchecked")
HashMap<String, Object> copy = (HashMap<String, Object>) ois.readObject();
ois.close();
return copy;
}在 sensitiveWordFilter 中替换关键逻辑：
if (String.valueOf(char_).equals(key)) {
HashMap<String, Object> originalNested = (HashMap<String, Object>) map.get(key);
HashMap<String, Object> clonedNested = deepCopy(originalNested); // ← 真正独立副本
Map<String, Object> newMap = new HashMap<>();
newMap.put(key, clonedNested);
futureMap = (HashMap<String, Object>) newMap;
}⚠️ 注意事项与替代建议
- 性能权衡：序列化深拷贝涉及 I/O 和反射，频繁调用会影响性能；高频场景可考虑 Google Guava 的 Maps.newHashMap() 配合手动递归克隆，或使用 Jackson/Gson 序列化 JSON 字符串再反序列化（适用于纯 POJO）。
- 局限性：含不可序列化字段（如 ThreadLocal、Socket）、匿名内部类或 Lambda 表达式的对象无法被序列化深拷贝。
- 更健壮的设计：敏感词过滤推荐使用 Trie（字典树）结构，配合不可变节点或每次 traversal 创建新路径节点，从设计上规避共享状态问题。
总之，理解 putAll() 的浅拷贝本质是避免隐蔽副作用的关键；而按需选用序列化、第三方库或重构数据结构，才能写出线程安全、行为可预测的工业级代码。
