← 课程目录 🚀 从零到一
📐 学习维度 阶段2 · 第7章 并发编程 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

7.7 ThreadLocal:各用各的储物柜,和它藏不住的泄漏

审校 2026-09-26 · 素材来源:L05-ThreadLocal原理与内存泄漏(底稿改写)
📑 本篇章节导航 (共12节,点击直达)
ThreadLocal 是什么存在哪:反直觉的引用方向为什么会内存泄漏正确姿势:finally 里 remove想把值传给线程池里的线程?哪些场景适合它和 synchronized 怎么分工经典案例:SimpleDateFormat 的三种治法亲眼看一次泄漏(十行实验)踩坑清单面试怎么问一句话总结

线上出了诡异 bug:用户 A 偶尔看到用户 B 的数据。查了半天,肇事者是 ThreadLocal 在线程池里没清理——线程是复用的,上一个请求存的东西还在柜子里。这一节讲清它怎么用、为什么会漏、怎么治。

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),但你不碰它它就不清,线程池里恰恰常年不碰——所以不能指望。

正确姿势:finally 里 remove


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 怎么分工

同一份数据既要共享又要改,用 synchronized 或 Atomic 排队;各线程各一份、互不借用,用 ThreadLocal。前者省内存费排队,后者费内存免排队。SimpleDateFormat 就属于后者——它压根不需要共享,只是创建有点贵,那就一人一个。也有两者合体的:数据库连接池用锁管共享的池子,连接借出期间的事务上下文用 ThreadLocal 绑定——共享的归锁,独占的归柜子。

经典案例:SimpleDateFormat 的三种治法

它内部有共享状态,并发 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——不然下个人打开就是你的毛巾。