ThreadLocal内存泄露的根本原因是什么？为何弱引用Key需手动remove以避免泄露？

本文共计596个文字，预计阅读时间需要3分钟。

ThreadLocalMap中的Entry继承自WeakReference。

线程长期存活时，失效 Entry 不会自动清理

ThreadLocalMap 确实有惰性清理机制，会在 get()、set()、remove() 时顺手扫描并清理 key == null 的 Entry，但这不是实时、全覆盖的：

• 如果线程执行完任务后不再调用任何 ThreadLocal 方法，就不会触发清理
• 清理只扫哈希桶附近几个位置，不是全表遍历
• 一个 Entry 被标记为“key == null”后，其 value 可能永远卡在内存里，直到线程结束

在线程池场景中，线程复用频繁，但很多任务根本不碰 ThreadLocal，这就导致大量“幽灵 value”持续堆积。

为什么不能只靠 GC 回收 ThreadLocal 就万事大吉？

常见误解是：“我把 ThreadLocal 变量设为 null 或让它出作用域，GC 一收，整个 Entry 就没了”。