ThreadLocal在什么情况下会导OOM？

文章内容收录到个人网站，方便阅读 ：hardyfish.top/

ThreadLocal 本身设计上是为了解决线程之间共享变量带来的并发问题，但使用不当时，确实可能导致内存泄露甚至最终导致 OutOfMemoryError（OOM） 。下面是具体可能导致 OOM 的几种情况：

一、根本原因：ThreadLocalMap 的 Entry 是弱引用，但 value 是强引用

在 ThreadLocal 的底层实现中，每个线程 (Thread) 都维护一个 ThreadLocalMap，其 key 是 ThreadLocal 对象的 弱引用 ，value 是实际存储的对象，强引用。

弱引用的影响：

如果你没有保存对 ThreadLocal 实例的强引用，GC 后它可能会被回收，但其对应的 value 仍然存在，ThreadLocalMap 里的 entry 的 key 就变成了 null，但 value 还在，导致内存泄露。

二、常见导致 OOM 的场景

场景 1：线程池 + ThreadLocal 使用不当

线程池中的线程是长期存活的；
如果使用完 ThreadLocal 后不调用 remove()，它的 value 会一直保留在线程中，不能被回收；
如果这个 value 是大对象（如数据库连接、缓存、List 等），会导致内存不断积累；
长时间运行后，堆内存爆满，抛出 OutOfMemoryError: Java heap space。

典型例子 ：在 Web 应用中，使用线程池处理请求并使用 ThreadLocal 缓存用户信息或数据库连接等大对象。

场景 2：频繁创建 ThreadLocal 实例，没有 remove() 清理

每次请求都新建一个 ThreadLocal 对象，丢弃引用不调用 remove()，GC 后 key 被清除但 value 还在，时间久了堆积大量无法访问的对象，也会造成 OOM。

三、解决建议

✅ 正确使用方式

java 复制代码

ThreadLocal<MyObject> threadLocal = new ThreadLocal<>();

try {
    threadLocal.set(new MyObject());
    // do something
} finally {
    threadLocal.remove(); // 避免内存泄漏
}

✅ 使用 `InheritableThreadLocal` 或 `TransmittableThreadLocal` 时更要小心

它们可能在跨线程传递 ThreadLocal 时保留引用，清理不及时也可能导致内存泄漏。

四、总结

问题原因	是否易复现	是否能导致 OOM
使用线程池后未调用 `remove()`	✅	✅
未持有 ThreadLocal 实例引用	✅	❌（内存泄漏但未必 OOM）
每次创建新 ThreadLocal 且未清理	✅	✅
value 是大对象	✅	✅