WeakHashMap 是什么？它的 key 为什么会自动消失？适合什么场景？

简化版

WeakHashMap 是一个特殊的 Map——它的 key 用「弱引用（WeakReference）」持有，所以当一个 key 对象除了 WeakHashMap 之外没有任何其他强引用时，这个 key 会被 GC 回收，对应的 entry 也随之自动从 Map 中移除。普通 HashMap 的 key 是强引用（放进去就一直被 Map 引用着、不会被回收，容易内存泄漏）；WeakHashMap 的 key「跟随外部引用的生死」——外部不再用这个 key，它就自动清理。适合的场景：做「跟随对象生命周期的缓存/元数据」——比如给某些对象附加额外信息（key=对象、value=元数据），当对象被回收时，附加信息也自动清理，不用手动 remove，避免内存泄漏。

详细版

WeakHashMap vs HashMap（key 的引用类型）：

// HashMap：key 是强引用——放进去就一直被 Map 引用，不会被 GC（除非手动 remove）
Map<Object, String> strong = new HashMap<>();
Object key = new Object();
strong.put(key, "value");
key = null;               // 去掉外部引用
// 但 Map 内部仍强引用着那个 key 对象 → 不会被回收 → 一直占内存

// WeakHashMap：key 是弱引用——外部引用没了，key 就会被 GC，entry 自动移除
Map<Object, String> weak = new WeakHashMap<>();
Object key2 = new Object();
weak.put(key2, "value");
key2 = null;              // 去掉外部强引用
System.gc();              // GC 后，key2 对象被回收
// weak 里那个 entry 自动消失了（size 变 0）

核心机制：

WeakHashMap 的 key 用 WeakReference 包装：
  只要 key 对象还有"外部强引用" → key 存活，entry 保留
  一旦 key 对象"只被 WeakHashMap 弱引用"（没有其他强引用） → 下次 GC 时 key 被回收
    → WeakHashMap 检测到（通过 ReferenceQueue），自动移除对应 entry

清理时机：不是 key 被回收就立即移除，而是在下次访问 WeakHashMap（get/put/size 等）时，
         它会先清理"已被回收的 key 对应的 entry"（惰性清理）

维度	HashMap	WeakHashMap
key 引用类型	强引用	弱引用
key 是否会自动消失	否（除非手动 remove）	是（外部无强引用时自动清理）
典型用途	普通键值存储	跟随对象生命周期的缓存/元数据
内存泄漏风险	有（忘记 remove）	低（自动清理）

⚠️ 注意是「key 弱引用」不是「value 弱引用」——WeakHashMap 的 value 仍是强引用。有个隐蔽的坑：如果 value 直接或间接强引用了 key（如 weakMap.put(obj, obj) 或 value 里存了 key），那 key 就永远有强引用（被 value 引用着）、永远不会被回收，WeakHashMap 就失效了（entry 不会自动清理）。所以用 WeakHashMap 时要确保「value 不引用 key」。

完整版教学

一、先理解四种引用强度

要理解 WeakHashMap，先回顾 Java 的四种引用强度（前面「引用类型」题详讲，这里聚焦弱引用）：

强引用（Strong）：Object o = new Object() —— 只要有强引用，对象绝不被回收
软引用（Soft）：内存不足时才回收 —— 适合内存敏感的缓存
弱引用（Weak）：只要发生 GC 就回收（不管内存够不够）—— WeakHashMap 用它
虚引用（Phantom）：最弱，用于跟踪对象回收

弱引用的特点是「只要 GC 发生，被弱引用的对象（若没有强引用）就会被回收」——它不阻止 GC。WeakHashMap 正是用弱引用包装 key：key 只被 WeakHashMap 弱引用时，一次 GC 就会把它回收。理解「弱引用不阻止 GC、GC 就回收」，就理解了 WeakHashMap「key 自动消失」的根源——它的 key 是弱引用，所以「外部没有强引用 + GC」就会让 key 消失。这是 WeakHashMap 一切行为的基础。

二、WeakHashMap 的核心：key 自动消失

WeakHashMap 和 HashMap 的唯一本质区别是——key 的引用类型不同：

HashMap：key 是强引用
  put(key, value) 后，Map 内部强引用着 key
  → 即使外部把 key 置 null，Map 还引用着，key 不会被回收
  → key 一直存活（除非手动 remove）→ 可能内存泄漏

WeakHashMap：key 是弱引用（用 WeakReference 包装）
  put(key, value) 后，Map 内部只弱引用 key
  → 外部把 key 的强引用去掉后，key 只剩 WeakHashMap 的弱引用
  → 下次 GC，key 被回收 → WeakHashMap 自动移除这个 entry

关键效果：WeakHashMap 里的 entry「跟随 key 的外部引用而生死」——只要外部还在用这个 key（有强引用），entry 就保留；外部不再用了（没有强引用），entry 就自动清理。这让 WeakHashMap 成为「不会造成 key 内存泄漏的 Map」——你不用担心「忘记 remove 导致 key 一直占内存」，因为外部不用了它就自动没了。理解「WeakHashMap 的 key 弱引用、entry 跟随外部引用生死、自动清理」，就抓住了它的核心特性。

三、清理时机：惰性清理

一个容易误解的点——WeakHashMap 不是「key 被回收的瞬间就移除 entry」，而是「惰性清理」：

key 被 GC 回收后，WeakHashMap 里的 entry 不会立即消失，
而是等到下次"访问 WeakHashMap"时（调 get/put/size/remove 等）才清理：

清理机制：
  WeakHashMap 内部有一个 ReferenceQueue（引用队列）
  key 被 GC 回收时，对应的 WeakReference 被放进这个队列
  下次访问 WeakHashMap 时，它先"排空队列"——把队列里那些"已回收 key"对应的 entry 移除
  然后再执行你的操作（get/put 等）

所以：① key 被回收 ≠ entry 立即消失（要等下次访问才清理）；② size() 的值可能「暂时不准」（在 key 已回收但还没清理时）——不过一旦你访问它，它会先清理再返回。这个「惰性清理」的设计是为了性能（不用为每个 key 的回收都触发清理）。理解「WeakHashMap 惰性清理、下次访问时才移除已回收 key 的 entry、靠 ReferenceQueue 检测」，就理解了它的清理机制——不是实时的，但访问时保证一致。

四、经典应用：跟随对象的元数据/缓存

WeakHashMap 最典型的用途是「给对象附加额外信息，且信息随对象一起消亡」：

// 场景：给某些对象附加"元数据"，但不想因为这个 Map 而阻止对象被回收
Map<SomeObject, Metadata> metadataMap = new WeakHashMap<>();
metadataMap.put(obj, new Metadata(...));   // 给 obj 附加元数据
// 当 obj 在别处不再被引用、被回收时 → metadataMap 里的这条元数据自动清理
// → 不用手动管理"obj 没了要删元数据"，避免内存泄漏

为什么用 WeakHashMap 而不是 HashMap？如果用 HashMap，把对象当 key 放进去，Map 就强引用了这个对象——即使对象在业务上已经「不用了」，Map 还引用着它，导致对象无法回收（内存泄漏），且元数据也一直留着。用 WeakHashMap，对象被回收时元数据自动清理，完美契合「元数据的生命周期跟随对象」的需求。典型场景：① 给第三方对象附加信息（你改不了对象的类，只能外挂信息）；② 对象级别的缓存/标记（缓存跟随对象生死）；③ 监听器/回调的弱引用注册（避免监听器阻止对象回收）。理解「WeakHashMap 用于跟随对象生命周期的元数据/缓存、避免内存泄漏」，就掌握了它的实战价值。

五、和软引用缓存的区别

WeakHashMap（弱引用）和「软引用缓存」（SoftReference）常被拿来对比，它们的回收时机不同：

WeakHashMap（弱引用 key）：
  只要 GC 发生 + key 无外部强引用 → 立即可回收
  → key「一没人用就消失」，不适合做"想尽量保留的缓存"
  → 适合"元数据"（跟随对象、对象没了就该清理）

软引用缓存（SoftReference）：
  内存充足时保留、内存不足时才回收
  → 「尽量保留，内存紧张才丢」，适合"缓存"（想多留一会儿，实在没内存才清）
  → 如图片缓存、计算结果缓存

对比：
  弱引用（WeakHashMap）：一 GC 就回收 → "跟随生命周期"
  软引用：内存不足才回收 → "内存敏感的缓存"

选择：需要「跟随对象生命周期、对象没了就清理」→ WeakHashMap（弱引用）；需要「尽量保留的缓存、内存不足才清」→ SoftReference（软引用）。很多人误以为 WeakHashMap 适合做「缓存」，其实它的 key「一没强引用就消失」，做缓存会「刚放进去就被清掉」（如果没有其他地方强引用 key）——它更适合「元数据」。真正的内存敏感缓存应该用软引用或专业缓存库（Guava Cache、Caffeine）。理解「WeakHashMap 弱引用一 GC 就回收适合元数据、软引用内存不足才回收适合缓存」，就分清了它们的适用场景。

六、使用注意与替代

用 WeakHashMap 有几个注意点：

① value 不能（直接或间接）强引用 key：
   否则 key 永远有强引用（被 value 引用着）、永不回收 → WeakHashMap 失效
   weakMap.put(obj, obj)  ✗ value 引用了 key，key 不会被回收

② key 的选择要注意：
   用 String/Integer 等可能被"常量池/缓存"强引用的对象做 key，可能一直不被回收
   （如小整数 Integer 缓存、字符串常量池的字符串有强引用）

③ 非线程安全：和 HashMap 一样非线程安全，并发要外部同步

替代/相关：
  - 想要"value 弱引用" → 没有现成的，可用 Map<K, WeakReference<V>> 自己包
  - 想要专业缓存（过期、容量、弱/软引用可选）→ Guava Cache / Caffeine
  - Netty 的 FastThreadLocal、ThreadLocalMap 的 key 也用弱引用（类似思想）

关键注意是 ① value 别引用 key（否则失效）、② 别用被常量池/缓存强引用的对象做 key（否则不会被回收）。实践中 WeakHashMap 的直接使用不多，但「弱引用做 key 自动清理」的思想很重要——ThreadLocalMap 的 key 就是弱引用（前面 ThreadLocal 题讲过的「key 弱引用、value 强引用导致的内存泄漏」，正是这个机制）。理解「WeakHashMap 的注意点（value 别引用 key）和替代方案（Guava/Caffeine 做缓存）」，就能正确使用它，也理解了 ThreadLocal 的底层。

记忆钩子：「WeakHashMap 的 key 是弱引用（value 仍强引用）——key 只被它弱引用（外部无强引用）时，一次 GC 就被回收、entry 自动移除（惰性清理，下次访问时才清、靠 ReferenceQueue）；适合『跟随对象生命周期的元数据』（对象没了信息自动清，避免内存泄漏）；坑：value 别引用 key（否则失效）、别用常量池对象做 key；做缓存该用软引用或 Guava/Caffeine；ThreadLocalMap 的 key 也用弱引用」。

七、常见误区与追问

误区：WeakHashMap 的 key 和 value 都是弱引用。 只有 key 是弱引用，value 仍是强引用；如果 value 引用了 key，key 就有强引用、永不回收，WeakHashMap 失效。
误区：key 被回收后 entry 立即消失。 是惰性清理——key 被 GC 回收后，entry 要等下次访问 WeakHashMap（get/put/size 等）时才被移除（靠 ReferenceQueue 检测）。
误区：WeakHashMap 适合做缓存。 它的 key 一没强引用就被回收（可能刚放进去就被清），适合「跟随对象生命周期的元数据」；内存敏感的缓存应用软引用或 Guava Cache/Caffeine。
误区：WeakHashMap 是线程安全的。 和 HashMap 一样非线程安全，并发访问要外部同步或用其他并发方案。
追问：WeakHashMap 的 key 为什么会自动消失？ key 用弱引用包装，当 key 对象除了 WeakHashMap 外没有其他强引用时，下次 GC 就会回收它，WeakHashMap 通过 ReferenceQueue 检测到并自动移除对应 entry。
追问：WeakHashMap 和软引用缓存有什么区别？ WeakHashMap 用弱引用（一 GC 就回收、跟随对象生命周期、适合元数据）；软引用缓存内存充足时保留、内存不足才回收（适合内存敏感的缓存）。
追问：用 WeakHashMap 要注意什么？ value 不能直接或间接强引用 key（否则 key 永不回收、失效）；别用被常量池/缓存强引用的对象（String/小 Integer）做 key；非线程安全。

八、加强记忆

WeakHashMap 的核心是「key 用弱引用持有」（value 仍是强引用）——当一个 key 对象除了 WeakHashMap 外没有其他强引用时，下次 GC 就会被回收，对应 entry 自动移除（对比 HashMap 的 key 是强引用、放进去就一直存活、易内存泄漏）。清理是惰性的：key 被回收后 entry 不立即消失，而是下次访问 WeakHashMap（get/put/size）时才清理（靠内部 ReferenceQueue 检测已回收的 key）。它适合「跟随对象生命周期的元数据/标记」——给对象附加信息、对象被回收时信息自动清理（避免内存泄漏），如给第三方对象外挂信息、对象级缓存、弱引用监听器。要注意：① value 不能（直接/间接）强引用 key（否则 key 永不回收、失效）；② 别用被常量池/缓存强引用的对象（String/小 Integer）做 key；③ 非线程安全。它和软引用不同：弱引用（WeakHashMap）一 GC 就回收适合元数据，软引用内存不足才回收适合缓存——真正的缓存该用软引用或 Guava Cache/Caffeine。ThreadLocalMap 的 key 也用弱引用（同源机制）。一句话「WeakHashMap 的 key 弱引用（value 强引用）、外部无强引用一 GC 就回收 entry 自动清（惰性）、适合跟随对象的元数据、value 别引用 key、缓存用软引用或 Caffeine」。

简化版

详细版