线程池复用线程后,ThreadLocal 不 remove 会把上下文串到别人身上
日志里的 traceId 变成了别人的、租户上下文偶尔错乱、堆里堆着一批本该释放的对象——这三个现象常常是同一个原因:ThreadLocal 用完没 remove。这篇讲清 ThreadLocalMap 的引用结构,给出可靠的清理写法。
ThreadLocal 的数据是挂在线程对象上的,线程池的线程不会销毁,所以只要没主动 remove,上一个任务写进去的值就会原样留给下一个任务。它带来两类问题:上下文串味,以及对象长期滞留。
串味为什么是「偶发」的
典型现场是日志排查时发现某条请求的 traceId 属于另一个用户,或者权限校验用到的租户 ID 突然变成了别人的。这类问题难复现,因为只有在同一个工作线程刚好被复用时才会发生:并发低的时候线程池不断新建线程,看不出问题;压测或流量高峰时线程被反复复用,错误就集中出现。
ThreadLocalMap 的引用结构决定了回收时机
每个 Thread 对象里有一个 threadLocals 字段,指向一个 ThreadLocalMap。这个 map 的 key 是 ThreadLocal 实例的弱引用,value 是普通强引用。
线程结束时整个 map 随线程一起被回收,所以普通 new Thread 的场景通常感觉不到泄漏。但线程池的线程是常驻的,map 一直活着。key 被 GC 回收后 entry 变成 key 为 null 的状态,而 value 仍然被 entry 强引用着,只有在后续 set/get 恰好命中并触发清理时才会被清掉。
所以「key 是弱引用所以不会泄漏」这个说法是错的:弱引用只保证 key 能被回收,value 要靠显式 remove 或侥幸被清理。
把 remove 放进 finally
手动提交任务时,包装一层是最直接的做法:
public <T> T runWithContext(Supplier<T> task) {
RequestContext ctx = new RequestContext();
CONTEXT.set(ctx);
try {
return task.get();
} finally {
CONTEXT.remove(); // 必须在 finally,且不要放在 return 之后
}
}
Spring 项目里更省事的做法是实现 TaskDecorator,交给线程池统一处理,业务代码不用每处都记得清理:
@Bean
public ThreadPoolTaskExecutor bizExecutor() {
ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
executor.setCorePoolSize(8);
executor.setMaxPoolSize(16);
executor.setQueueCapacity(200);
executor.setTaskDecorator(runnable -> {
Map<String, String> mdc = MDC.getCopyOfContextMap();
return () -> {
if (mdc != null) MDC.setContextMap(mdc);
try {
runnable.run();
} finally {
MDC.clear();
CONTEXT.remove();
}
};
});
executor.initialize();
return executor;
}
关键是这个 finally 必须是「复制上下文 → 执行 → 清理」的完整闭环,而不是只在入口 set 一次就放任不管。用 CompletableFuture.supplyAsync 时也一样,公共池的线程是全 JVM 共享的,串味范围比自建线程池更大。
边界与常见坑
InheritableThreadLocal 并不能解决线程池的问题:它只在 new Thread 时把父线程的值复制过去,而线程池的线程往往在任务提交之前就已经创建完毕,复制发生的时点根本对不上,拿到的可能是第一个提交者的值。
需要跨线程传递又不想到处改签名时,可以引入能在提交任务时捕获快照的工具(如 TransmittableThreadLocal),但它也要求任务包装到位,否则同样失效。
另外两个细节:一是 remove 要放在最外层 finally,如果中间有嵌套的 try 且 return 在 finally 之前,很容易漏掉;二是不要把大对象(比如完整的请求体、查询结果集)塞进 ThreadLocal,即便清理正确,这类对象在单次请求的生命周期里也会显著抬高老年代占用,反而更容易触发 GC 压力。
最后,如果已经怀疑有泄漏,别急着调堆大小,先用堆 dump 看 ThreadLocalMap 里残留的 value 是什么类型、挂在哪些线程上,定位到具体业务入口再改,比全局加 remove 更有效。
正在加载评论…