一、ThreadLocal 是什么ThreadLocal 是线程本地变量作用让每个线程拥有一份独立、私有变量副本。 多线程场景下多个线程共用同一个 ThreadLocal 对象但各自读写的数据互不干扰、互相隔离天然线程安全不需要加锁。核心一句话数据绑定在线程身上线程之间数据隔离。简单示例ThreadLocalString tl new ThreadLocal(); // 线程1 new Thread(()-{ tl.set(张三); System.out.println(tl.get()); // 张三 }).start(); // 线程2 new Thread(()-{ tl.set(李四); System.out.println(tl.get()); // 李四 }).start();两个线程 get 拿到各自存入的值互不影响。二、底层存储结构核心考点很多人误以为 ThreadLocal 内部维护一个 Mapkey 线程value 数据这是错误的。 真实存储结构每个Thread对象内部持有一个ThreadLocalMap threadLocalsThreadLocalMap 的 key 是ThreadLocal 对象本身弱引用value 是当前线程存放的变量副本关系梳理Thread→ ThreadLocalMap → Entry (key:ThreadLocal (弱引用), value: 业务数据)为什么不把 Map 存在 ThreadLocal 里如果 Map 存在 ThreadLocal线程多、ThreadLocal 多会产生巨大容量 Map竞争激烈 把 Map 放在 Thread 里数据跟随线程销毁天然分散存储压力分摊。三、ThreadLocalMap 内部细节底层是自定义哈希表数组存储 Entry无链表冲突采用线性探测法解决 hash 冲突Entry 继承 WeakReferencestatic class Entry extends WeakReferenceThreadLocal? { Object value; Entry(ThreadLocal? k, Object v) { super(k); value v; } }key 是弱引用value 是强引用。扩容阈值数组长度 2/3到达阈值扩容 2 倍。四、四大核心方法执行流程1. set(T value)获取当前线程 Thread拿到内部 ThreadLocalMapmap 不存在则创建 ThreadLocalMap以当前 ThreadLocal 实例为 key存入 Entry存入时自动清理数组中 key 被回收的过期 Entry。2. get()获取当前线程 ThreadLocalMap根据当前 ThreadLocal 对象 hash 定位 Entry找到 Entry 且 key 有效返回 value找不到则执行initialValue()初始化并 set查找过程同步清理过期弱 key Entry。3. remove()获取当前线程 map删除当前 ThreadLocal 对应的 Entry主动清理避免内存泄漏生产必须调用。4. initialValue()空参构造 ThreadLocal 时get 为空会调用此方法默认返回 null 可重写实现初始值ThreadLocalInteger tl new ThreadLocal(){ Override protected Integer initialValue() { return 0; } };五、重点难点内存泄漏问题1. 泄漏产生原因Entry 中keyThreadLocal → 弱引用无外部强引用时GC 会自动回收 keyvalue业务对象 → 强引用不会自动回收。场景ThreadLocal 对象外部引用置空key 被 GC 回收Entry 的 key 变成 null但 value 依旧强引用如果线程长期存活线程池核心线程Thread 不会销毁ThreadLocalMap 不会销毁大量 keynull 的 Entry 堆积value 无法释放造成内存泄漏。2. 解决方案强制记住使用完必须手动调用 tl.remove ()用完立刻删除当前线程对应 Entry从根源消除泄漏线程池场景尤其重要线程复用不 remove 会携带旧数据 持续泄漏。六、两大经典使用场景场景 1跨层参数透传避免方法传参污染例如 Web 请求链路用户登录信息、请求 traceId Controller → Service → Mapper 多层都需要用户 ID如果每层方法都传参代码冗余。 用 ThreadLocal 存入登录用户任意层直接 get不用层层传递。场景 2多线程数据隔离不用加锁SimpleDateFormat 非线程安全不能静态共用 可以每个线程绑定一个 SimpleDateFormat 副本ThreadLocal 隔离无需同步锁性能更好。七、ThreadLocal vs synchronized 锁核心对比设计思路完全相反synchronized时间隔离同一时间只有一个线程操作共享变量排队等待ThreadLocal空间隔离每个线程独有副本无共享竞争完全不用锁。性能 ThreadLocal 无锁、无竞争并发性能远高于同步锁适用场景 synchronized多线程需要共享、修改同一资源 ThreadLocal线程私有数据不需要共享。八、线程池使用 ThreadLocal 的坑线程池线程复用线程不会销毁若不执行 remove ()下一个任务 get 会拿到上一个任务遗留的旧数据业务错乱长期运行产生大量过期 Entry内存泄漏 规范try-finally 结构finally 中执行 removetry { threadLocal.set(data); // 业务逻辑 } finally { threadLocal.remove(); }九、精简口述总结ThreadLocal 实现线程私有变量隔离每个 Thread 内置 ThreadLocalMapkey 为弱引用 ThreadLocal存取自动清理过期 entry弱引用 key 配合强引用 value 在线程池场景易内存泄漏用完必须 remove适合链路透传、线程私有工具类靠空间隔离避免锁竞争和 synchronized 时间互斥思路相反。