threadlocal 的核心机制是线程隔离，每个线程持有独立副本，值实际存储在 thread 对象的 threadlocals（threadlocalmap）中，threadlocal 实例仅作 key；内存泄漏主因是弱引用 key 与强引用 value 不匹配且未调用 remove()，尤其 static 声明加剧风险，需显式清理。
ThreadLocal 的核心机制是“线程隔离”，不是“全局单例”
很多人误以为 ThreadLocal 是用来共享变量的，其实它恰恰相反：每个线程持有一份独立副本。JVM 并不把值存在 ThreadLocal 实例里，而是存在当前线程对象的 threadLocals 字段中——这是一个 ThreadLocalMap 类型的私有成员。
关键点在于：ThreadLocal 本身只是个 key，真正的 value 存在 Thread 对象内部。所以哪怕你 new 出十个 ThreadLocal 实例，只要没调用 set()，就不会在当前线程里存任何数据。
-
get()本质是：从当前线程的threadLocals中，以当前ThreadLocal实例为 key 查 value -
set(T value)本质是：往当前线程的threadLocals里 put（key=当前 ThreadLocal，value=传入值） -
remove()必须显式调用，否则 entry 一直留在 map 里，哪怕 ThreadLocal 实例已不可达
内存泄漏的根本原因是“弱引用 key + 强引用 value” + 未调用 remove()
ThreadLocalMap 的 entry 继承自 WeakReference<threadlocal></threadlocal>，也就是说 key 是弱引用，GC 时若无外部强引用，key 可被回收；但 value 是强引用，不会随 key 一起消失。
典型泄漏场景：在线程池中使用 ThreadLocal（如 Web 容器的 worker 线程），线程长期存活，而业务逻辑中只 set() 不 remove()。一旦该 ThreadLocal 实例被回收（比如 Spring Bean 销毁后），map 中就留下一个 key==null、value 仍指向大对象的 stale entry。
立即学习“Java免费学习笔记（深入）”；
- 这个 value 不会被自动清理，除非后续对该 map 做 get/set/remove 操作触发探测式清理（rehash 时顺带扫一遍）
- 但线程池线程可能长期 idle，不触发操作，value 就一直占着堆内存
- 更危险的是：value 若持有外部对象引用（如某个 Service、上下文 Map），会间接阻止整条引用链上的对象回收
为什么 static ThreadLocal 更容易出问题？
声明成 static 的 ThreadLocal 实例生命周期通常与类加载器一致，很难被回收。这看似“稳定”，实则放大泄漏风险：
- key 很难变成 null（因为 static 引用一直存在），本该靠弱引用机制触发的清理失效
- 但 value 依然绑定在线程上，线程不结束，value 就不释放
- 尤其在 OSGi、热部署、Web 应用重启等场景下，static 引用可能导致 classloader 泄漏
正确做法是：尽量避免 static ThreadLocal；如果必须用，务必在业务结束时配对调用 remove()，例如在 Filter 的 doFilter() finally 块中，或 Spring 的 @AfterReturning/@AfterThrowing 通知里。
如何验证和定位 ThreadLocal 泄漏？
不能只看堆内存增长，要确认是不是 ThreadLocalMap$Entry 中的 value 在堆积。常用手段：
-
jstack + jmap 配合：先用
jstack <pid></pid>找到可疑线程（如 Tomcat 的 http-nio-8080-exec-*），再用jmap -histo:live <pid> | grep Entry</pid>看数量是否异常增长 - 用 MAT（Memory Analyzer）打开 heap dump，按 dominator tree 查看哪些对象被
java.lang.Thread→threadLocals→value持有 - 开启 JVM 参数
-XX:+PrintGCDetails -XX:+PrintGCTimeStamps，观察 Full GC 后 old gen 是否持续不下降——可能是 ThreadLocal value 持有大对象且未释放
最直接的防护写法：
private static final ThreadLocal<SimpleDateFormat> DATE_FORMAT = ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd"));
注意：用 withInitial() 替代匿名内部类 set，它会在首次 get() 时初始化，并且底层已做了一定的 clean up 优化；但仍需在明确生命周期结束处调用 DATE_FORMAT.remove()。
真正棘手的从来不是原理，而是那个“我以为它自己会清”的瞬间。
