WeakHashMap适用于缓存、监听器注册和线程上下文快照等场景,其键为弱引用,GC可回收无强引用的键及对应条目;不适用于长期存储、常量键、高并发或需迭代稳定性的场景。

WeakHashMap 适合缓存类场景,尤其是对象生命周期由外部控制、不希望Map阻止对象被回收的情况。它的核心特性是“键为弱引用”,当键对象没有其他强引用时,GC 可随时回收该键及其对应条目——这和 HashMap 完全不同,也决定了它不能用于长期稳定存储。
缓存临时计算结果(非关键、可重建)
比如在解析 XML 或 JSON 时,对重复出现的字段名做轻量级字符串 intern 替代;或在图形渲染中缓存某次绘制用到的临时样式对象。这些对象本身可能被频繁创建又丢弃,WeakHashMap 能自动清理无效映射,避免内存泄漏。
- 键是业务对象(如 DTO 实例),且该对象本就只在局部作用域存活
- 值可以快速重新计算,丢失条目不影响正确性
- 不依赖 Map 的 size() 稳定性(因为 GC 后 size 会突变)
监听器/回调注册表(避免持有宿主对象)
典型如 Swing/AWT 中注册事件监听器,或自定义观察者模式。若用 HashMap 存 listener → component 映射,容易导致 component 无法被回收(listener 持有 component 引用,map 又持有 listener)。WeakHashMap 把 component 作为键,listener 作为值,就能让 component 被回收后,整条映射自动失效。
- 键是“被监听的目标对象”(如 UI 组件、数据模型)
- 值是监听器或回调函数,本身不延长目标对象生命周期
- 需配合 remove() 或定期 clean-up(WeakHashMap 不保证立即清理)
线程局部上下文快照(配合 ThreadLocal 使用)
有时需要跨方法传递轻量上下文(如 traceId、用户权限快照),但又不想污染调用栈或引入强引用链。可用 WeakHashMap
立即学习“Java免费学习笔记(深入)”;
- 注意 Thread 对象本身可能被复用(如线程池),所以更适合短生命周期线程
- 不要依赖 get() 返回非 null 值,始终做好空值处理
- 不适合高并发高频读写,内部使用的是非线程安全的哈希表结构
不适合的场景(务必避开)
WeakHashMap 不是 HashMap 的“更轻量替代品”。以下情况请直接用 HashMap、ConcurrentHashMap 或 Caffeine:










