WeakHashMap适用于键消亡即映射失效的场景，如UI组件元数据绑定、弱监听器注册、线程上下文快照；它仅弱化键，不弱化值，不能替代缓存，也不主动防泄漏，仅在键无强引用时协助GC清理条目。
WeakHashMap 不是用来“选来避免内存泄漏”的工具，而是为特定生命周期耦合关系设计的辅助结构。它不能替代缓存策略，也不能主动“防止泄漏”，只能在键对象本身已无强引用时，协助 GC 清理映射条目。用错场景，反而会引入隐蔽泄漏。
明确适用边界：只适用于“键消亡即映射失效”的场景
WeakHashMap 的价值在于解耦——当键对象（如 UI 控件、Socket 连接、临时请求上下文）被业务逻辑释放后，你不需要手动清理关联数据，系统能自动断开绑定。典型例子：
- JButton 实例 → 对应 Tooltip 配置（按钮 dispose 后，配置自动消失）
- Netty Channel → 绑定的业务上下文标签（连接 close 后，标签条目自然失效）
- Spring AOP 中的目标 bean → 其代理增强元数据（bean 销毁后，元数据不再有意义）
如果键是长期存活的对象（如用户 ID 字符串、单例服务），或 value 本身持有 key 的强引用（比如 lambda 捕获、内部类字段），WeakHashMap 就完全失效，甚至加剧泄漏。
键必须可回收，且不能来自常量池或静态持有
WeakHashMap 只对“仅被弱引用持有”的键生效。以下写法会让 WeakHashMap 形同虚设：
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
String 字面量作 key：如
cache.put("user_1001", data)—— 字符串驻留在常量池，永不回收 -
静态 final 对象作 key：如
public static final KEY = new ConfigKey()—— 类加载器强引用该实例 - key 被存入 ThreadLocal / 静态监听器链 / 缓存容器：外部强引用锁死回收路径
正确做法是使用 new 出来的轻量不可变对象，例如：new RequestContext(requestId)，并确保该实例只在局部作用域或短期生命周期组件中流转。
value 必须轻量，或主动弱化
WeakHashMap 只弱化 key，value 始终是强引用。若 value 是大对象（图片缩略图、JSON 字节数组、完整 DTO），即使 key 被回收，value 仍滞留内存且无法访问——这就是 Hutool WeakCache 泄漏的根源。
- 优先用不可变小对象：
String、Integer、Boolean、枚举等 - 若 value 确实较大，需手动包装：
new WeakReference<BigValue>(bigValue)或SoftReference - 绝对禁止 value 中持有 key 的强引用，否则形成循环引用，key 永远无法回收
注意行为不确定性与并发安全
WeakHashMap 的清理不是实时的，而是在下一次 get、put、size 或扩容时触发 expungeStaleEntries()。这意味着：
-
size()返回值不稳定，不能用于业务判断（如“缓存未满才写入”） - 遍历时可能抛
ConcurrentModificationException，也不保证遍历完整性 - 多线程环境下必须同步：低并发可用
Collections.synchronizedMap(new WeakHashMap<>())；高并发建议封装成加锁类，避免裸用
它不是通用 Map 替代品，更不是缓存框架。内存敏感场景下，真正推荐的是 Caffeine 或 Guava Cache——它们支持弱键/弱值、软引用、LRU 驱逐、定时过期等可控策略，语义清晰、行为确定。
