ThreadLocal 存大型对象易OOM，因其value强引用导致线程池中对象长期驻留堆内存，且key弱引用引发“幽灵entry”；须在finally中显式remove()并用MAT分析Entry数量与大小。
ThreadLocal 存大型对象为什么容易 OOM
因为 ThreadLocal 持有的对象不会随线程结束自动清理，尤其在线程池复用场景下，ThreadLocal 变量长期存活，所引用的大型对象（如 byte[]、ArrayList、缓存 Map）会持续占据堆内存，且 GC 无法回收——只要线程还活着，ThreadLocalMap 的 Entry 就强引用着值。
常见错误现象：java.lang.OutOfMemoryError: Java heap space 频发，但堆 dump 显示大量对象路径最终指向 java.lang.ThreadLocal$ThreadLocalMap；或频繁 Full GC 后老年代占用不降。
- Web 容器（Tomcat/Jetty）中每个请求线程来自线程池，
ThreadLocal若未手动remove()，生命周期可能长达数小时 -
ThreadLocal的 key 是弱引用，value 是强引用 —— key 可能被回收导致“内存泄漏”，但 value 还卡在 map 里，形成“幽灵 entry” - 使用
static final ThreadLocal<BigObject>看似安全，但若BigObject内部持有外部类引用（如匿名内部类），会意外延长整个闭包对象的生命周期
排查时重点看 ThreadLocalMap 的 Entry 数量和 value 大小
不能只看 ThreadLocal 实例个数，要定位到它背后 ThreadLocalMap 中实际存了多少个未清理的 Entry，以及每个 value 占多少内存。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用
jmap -dump:format=b,file=heap.hprof <pid>抓堆快照，用 JProfiler / Eclipse MAT 打开后搜索java.lang.ThreadLocal$ThreadLocalMap，展开其table字段，统计非 nullEntry数量 - 在 MAT 中用 OQL 查询：
SELECT * FROM java.lang.ThreadLocal$ThreadLocalMap$Entry WHERE (OBJECTS this.value) INSTANCEOF "com.example.BigCache" - 检查
ThreadLocal初始化是否用了 lambda 或匿名类：这类写法常隐式捕获this，导致 value 引用整个服务类实例
正确清理 ThreadLocal 的三个必要动作
不是调一次 remove() 就万事大吉，必须匹配线程生命周期，在可靠出口处执行。
- 在使用
ThreadLocal的业务逻辑末尾（比如 Filter 的doFilter()结束前、Spring AOP @AfterReturning/@AfterThrowing 中）显式调用threadLocal.remove() - 若用在线程池任务中（如
ExecutorService.submit(Runnable)），务必在Runnable.run()最后加try-finally块包裹remove() - 避免在
ThreadLocal的initialValue()中创建大型对象；改用懒加载 + 显式初始化控制，例如：if (tl.get() == null) tl.set(new BigObject());
替代方案比死守 ThreadLocal 更稳妥
当对象体积超过几百 KB，或生命周期难以对齐请求/任务边界时，ThreadLocal 就不该是首选。
- 用方法参数透传：把上下文对象作为参数传入关键方法，明确所有权，避免隐式状态
- 用
InheritableThreadLocal？别——它在 ForkJoinPool 或异步线程中不可靠，且同样存在清理问题 - 考虑轻量级上下文容器，如 Spring 的
RequestContextHolder（Web 场景）、或自定义Scope+ApplicationContext管理，由框架负责销毁 - 真要缓存大对象？用带 LRU 和软/弱引用的本地缓存（如
Caffeine.newBuilder().maximumSize(100).weakValues()），而不是绑死在线程上
最常被忽略的一点：很多团队在压测时发现 OOM，回溯发现 ThreadLocal 的 remove() 被放在了 try 块里，而异常抛出后根本没走到那里。必须用 finally，且确保 remove() 不会抛异常（可包装成 try { tl.remove(); } catch (Throwable ignored) {}）。
