WeakReference用于打破强引用链以助GC及时回收，适用于缓存、监听器注册表等场景；不适用于需稳定生命周期的对象或规避空指针。
WeakReference 什么时候该用，什么时候不该用
WeakReference 不是用来“优化性能”的，它是用来打破强引用链、让对象能被 GC 及时回收的。典型场景是：你持有一个对象的引用，但又不希望它阻止 GC——比如缓存、监听器注册表、内部状态映射表。
常见错误现象：OutOfMemoryError: Java heap space 出现在大量创建临时对象却长期被某个 Map 持有引用时；或者 GUI 组件销毁后，其监听器仍被静态容器强引用，导致整棵树无法回收。
- 该用：缓存值、事件监听器反注册辅助结构、ThreadLocal 的 value 清理（配合
WeakHashMap） - 不该用：需要稳定生命周期的对象（如 DAO 实例、配置单例）、作为主业务逻辑中的“可选引用”来规避空指针（这会让代码更脆弱）
- 注意：WeakReference 本身不阻止 GC，但它包装的对象一旦被回收，
get()就返回null，必须检查
WeakReference + ReferenceQueue 实现自动清理
只靠 WeakReference.get() 轮询判断是否为空，效率低且容易漏。配合 ReferenceQueue 才能主动感知回收事件，及时清理关联资源（比如从 Map 中移除条目）。
使用场景：构建自定义弱引用缓存，避免键或值残留；在对象被回收后释放 native 资源（需配合 finalize 或 Cleaner，但 WeakReference+Queue 更可控）。
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
ReferenceQueue是线程安全的，但 poll() 需要你自己循环调用，不能阻塞等待 - 不要在
ReferenceQueue的消费逻辑里做耗时操作，否则会卡住引用处理线程（虽然 JVM 不保证专用线程） - 示例关键片段：
ReferenceQueue<Object> queue = new ReferenceQueue<>(); WeakReference<Object> ref = new WeakReference<>(obj, queue); // ... 后续 Reference<? extends Object> enqueued = queue.poll(); // 非阻塞 if (enqueued != null) { // 清理对应资源，比如从 map.remove(ref) }
WeakReference 和 SoftReference、PhantomReference 的关键区别
三者不是“强度递减”的替代关系，而是解决不同问题：WeakReference 对 GC 最敏感，SoftReference 偏向缓存（JVM 内存不足时才清），PhantomReference 仅用于对象彻底不可达后的清理钩子。
参数差异和兼容性影响：它们都继承自 Reference，构造方式一致，但触发时机和用途完全不同。误用 SoftReference 当 WeakReference，可能导致 OOM；误用 PhantomReference 代替 WeakReference，则根本拿不到对象实例。
-
WeakReference：GC 发现只有弱引用指向对象 → 立即入队（下次 GC 周期即可回收） -
SoftReference：GC 会尽量保留，直到堆内存真正紧张（基于最近使用时间和 JVM 策略） -
PhantomReference：get() 永远返回null，只能通过ReferenceQueue感知回收完成，且必须配合cleaner或手动释放 native 资源
WeakHashMap 的底层其实不是“弱键 + 强值”，要注意这点
WeakHashMap 的 key 是弱引用，value 却是强引用——这意味着：如果 value 又反过来持有 key（比如 value 是一个包含 key 字段的对象），就会形成隐式强引用链，key 永远不会被回收，WeakHashMap 形同虚设。
常见错误现象：Map size 持续增长，key 对应的对象明明已无外部引用，但依然不从 Map 中消失；jmap -histo 显示大量 key 类型实例堆积。
- 必须确保 value 不持有对 key 的强引用（包括间接持有，比如嵌套类默认持外部类引用）
- 如果 value 需要访问 key 相关数据，考虑用
WeakReference<key></key>包装后再存入 value - 别依赖
WeakHashMap自动收缩：它的 Entry 是WeakReference，但清理依赖于 GC 后的 expungeStaleEntries() 调用，而这个方法只在 put/remove/size 等操作中触发，空闲 Map 不会自动清理
