线上出了诡异 bug:用户 A 偶尔看到用户 B 的数据。查了半天,肇事者是 ThreadLocal 在线程池里没清理——线程是复用的,上一个请求存的东西还在柜子里。这一节讲清它怎么用、为什么会漏、怎么治。
ThreadLocal(线程本地变量)给每个线程一个独立副本,互相看不见。健身房储物柜类比:大家进同一间房,但各用各的柜子,你的毛巾不会出现在我柜子里。
注意方向:它不是「解决共享」,而是「干脆不共享」。synchronized 是合用一个保险柜排队开,ThreadLocal 是一人一个柜子根本不用排。
static ThreadLocal<UserContext> ctx = new ThreadLocal<>();
ctx.set(new UserContext("张三")); // 存进当前线程的柜子
UserContext u = ctx.get(); // 只有当前线程拿得到"张三"
ctx.remove(); // 清空柜子(下文的关键!)
以为是 ThreadLocal 里存了个 Map<线程, 值>?正好相反——Map 挂在线程身上:
Thread ── 持有 ──> ThreadLocalMap ──> Entry(key, value)
│
key = ThreadLocal 对象(弱引用)
value = 你的值(强引用)
set 的时候,当前线程掏出自己的 map,以 ThreadLocal 对象为 key 存进去。所以数据跟着线程走,线程不死、map 不散。记住这条引用链,后面的泄漏分析全靠它一步步推。
这个 map 的 hash 冲突也不走链表,用开放地址法(占了就试下一个格子):因为一个线程的 ThreadLocal 通常就几个,连续内存连着扫更快,犯不上拉链表。
出事的是 key 和 value 的引用强度不对称:
1. key 是弱引用(WeakReference,GC 一来就回收):外部代码不再持有 ThreadLocal 对象时,key 被回收,Entry 里 key 变 null——设计者故意的,这样 ThreadLocal 本身不会漏
2. value 是强引用:Thread → map → Entry → value 这条链只要线程活着就在
3. 线程池的线程几乎不死:key 已 null、value 还挂着,谁也回收不了——这就是泄漏
还有个孪生 bug:线程池里线程被复用,上个任务 set 的 value 没清,下个任务一 get,拿到了别人的数据——用户串扰比泄漏更早爆雷。
ThreadLocalMap 有自清理(set/get 时顺手清 key 为 null 的 Entry),但你不碰它它就不清,线程池里恰恰常年不碰——所以不能指望。
pool.submit(() -> {
try {
ctx.set(new UserContext("张三")); // 进门存包
// ... 业务
} finally {
ctx.remove(); // 出门取包,必须放 finally
}
});
Web 场景的标准做法:拦截器里 preHandle 设置、afterCompletion 清理,一处收口,不散落在业务代码。框架把成对的 set 和 remove 包进了切面,业务想忘都难。
普通 ThreadLocal 不跨线程。InheritableThreadLocal 能在创建子线程时复制一份,但线程池的线程只创建一次,之后复用——第二次提交任务时传的还是老值。正解是阿里的 TransmittableThreadLocal(TTL):提交任务时捕获当前值,执行前回放到工作线程,执行后还原。
TransmittableThreadLocal<String> ctx = new TransmittableThreadLocal<>();
ctx.set("user_123");
pool.submit(TtlRunnable.get(() -> {
ctx.get(); // "user_123",提交时刻的快照
}));
链路追踪的 traceId 跨线程池不丢,靠的就是这类机制。
定位一句话:以线程为维度的「上下文」,常见四处:
共同点:数据「跟着一次请求走」,请求结束就该清——这正是 remove 的时机。判断某份数据该不该进柜子,只看一句:它的正确取值是否只由当前这条调用链决定——是,进柜子;要跨线程汇总共享,回到加锁的世界去。
同一份数据既要共享又要改,用 synchronized 或 Atomic 排队;各线程各一份、互不借用,用 ThreadLocal。前者省内存费排队,后者费内存免排队。SimpleDateFormat 就属于后者——它压根不需要共享,只是创建有点贵,那就一人一个。也有两者合体的:数据库连接池用锁管共享的池子,连接借出期间的事务上下文用 ThreadLocal 绑定——共享的归锁,独占的归柜子。
它内部有共享状态,并发 format 会输出错乱日期甚至抛异常。三种治法从粗到细:
// 治法一:方法内直接 new。对象轻量,多数场景最划算
new SimpleDateFormat("yyyy-MM-dd").format(date);
// 治法二:ThreadLocal 一线程一个,复用又不打架,重对象才值得
static ThreadLocal<SimpleDateFormat> fmt = ThreadLocal.withInitial(
() -> new SimpleDateFormat("yyyy-MM-dd"));
// 治法三(首选):换天生线程安全的不可变工具
static final DateTimeFormatter F = DateTimeFormatter.ofPattern("yyyy-MM-dd");
选型标准一条:对象贵不贵。便宜的方法内 new;贵的用 ThreadLocal 复用;本身不可变的,全局一个 static final 完事。别上来就 ThreadLocal——每次 get 都要走一遍 map,还背着忘记 remove 的债。
static ThreadLocal<byte[]> holder = new ThreadLocal<>();
ExecutorService pool = Executors.newSingleThreadExecutor();
for (int i = 0; i < 500; i++) {
pool.submit(() -> {
holder.set(new byte[1024 * 1024]); // 1MB 进柜
// 故意不 remove —— 对照实验
});
}
池里这条线程不死,柜里最新一条 1MB 永远躺着。用 jconsole 连上看堆曲线:一条斜线往上走;finally 里补一行 remove 再跑,曲线立刻躺平。想让现象更猛就把 -Xmx 压小,直接 OOM 给你看。建议亲手跑一遍,内存曲线比十篇讲义直观。
排查口诀从这来:线程池里 ThreadLocal 出问题,先查有没有 remove,再看 key 是不是 static 复用。再补一个面试变体:「ThreadLocal 为什么声明成 static」——同一个柜子应该只有一把钥匙,非 static 每次 new 一把新钥匙,柜子越开越多还互相看不见。反向提醒:set 和 remove 成对写、按「一次请求」为粒度,别在循环里高频进出柜子。
ThreadLocal 是挂在每个线程身上的储物柜(key 弱引用、value 强引用);线程池里柜子不换人,出门必须 remove——不然下个人打开就是你的毛巾。