WeakHashMap 适合缓存生命周期依赖于键对象本身的元数据，但不适合通用缓存场景。避免内存泄漏的关键是确保值对象不反向引用键对象，且键对象必须是可被垃圾回收的普通对象而非常量。
先说结论：WeakHashMap 只能防止键对象导致的泄漏，无法防止值对象持有键引用造成的循环引用泄漏，通用缓存建议改用 Caffeine 或 Guava Cache。
- 适合：键对象生命周期结束时需自动移除映射的场景，如监听器注册表、对象元数据绑定。
- 先看：值对象是否强引用了键对象，以及键对象是否为字符串常量或静态变量。
- 建议：高并发或严格内存控制场景优先使用 Caffeine，避免依赖 WeakHashMap 的惰性清理机制。
快速处理思路
若必须使用 WeakHashMap，请确保键对象没有全局强引用，且值对象内部不包含对键对象的强引用。以下是安全与不安全用法的对比：
// 不安全：值对象持有键的强引用，导致 key 无法被 GC
class Value { Object keyRef; }
map.put(key, new Value(key));
// 安全：值对象独立，不持有 key 引用
map.put(key, new IndependentValue());为什么会这样
WeakHashMap 的键被包装为弱引用，但值仍然是强引用。当键对象没有其他强引用时，GC 会回收键，但值对象仍留在内存中直到条目被清理。如果值对象反过来引用了键，会形成“键→值→键”的闭环，阻止键被回收。
分步处理
- 检查键类型：避免使用字符串常量或静态对象作为键，因为它们常驻内存不会被回收。
- 检查引用链：确认值对象内部没有保存键对象的引用，防止循环引用。
- 触发清理：WeakHashMap 清理是惰性的，需定期调用 get/put/size 方法触发 stale entry 清理，或手动管理。
- 评估替代方案：若需要更可靠的缓存策略，改用 Caffeine 或 Guava Cache，它们支持更完善的过期和清理机制。
怎么验证是否生效
通过 JVM 堆内存监控工具观察内存占用趋势。若 WeakHashMap 大小持续增长但有效 entry 很少，说明清理未生效。可使用 Heap Dump 分析是否存在“键→值→键”的循环引用链。
常见坑
- 字符串常量键：字符串常量池中的对象永远不会被 GC，导致 entry 永久残留。
- 惰性清理：长时间只读不写会导致失效 entry 堆积，size() 返回值虚高。
- 线程安全：WeakHashMap 不是线程安全的，并发环境下需额外同步。
- Null 键限制：WeakHashMap 不允许 null 作为键，会抛 NullPointerException。
常见问题
WeakHashMap 允许 null 作为键吗？
不允许。WeakHashMap 的键会被包装成 WeakReference，构造时 null 会直接抛出 NullPointerException。
为什么 WeakHashMap 不适合做通用缓存？
因为它的清理机制是惰性的，且无法防止值对象引用键导致的泄漏，通用缓存更需要主动过期策略。
有没有更好的替代方案？
有。对于缓存场景，推荐使用 Caffeine 或 Guava Cache，它们支持弱键/弱值、LRU 和定时过期，且清理更及时。
参考来源
- Java 中的 WeakHashMap 应用场景_缓存设计与内存泄漏防范
- 在 Java 中 WeakHashMap 如何避免内存泄漏_Java 弱引用集合解析
- Hutool 中的 WeakCache 与内存泄漏：原因、影响及解决方案
- 如何在 Java 中使用 WeakHashMap_弱引用与内存防泄漏应用