ThreadLocal

ThreadLocal 笔记

> Java 提供的局部变量工具类：每个线程都拥有一份完全独立的变量副本，互相不可见，天然线程安全。

一句话理解

把数据放进 ThreadLocal，取的时候永远拿到的是“当前线程自己那份”，别的线程改不动也看不到。

核心 API

方法	说明
T get()	返回当前线程的副本
void set(T value)	给当前线程放一份副本
void remove()	把当前线程那份删掉（防内存泄漏）
initialValue()	延迟初始化；未调用 set 时第一次 get() 会触发

底层实现

• 每个 Thread 对象里有一个 ThreadLocalMap（key = 弱引用 ThreadLocal 实例，value = 用户值）
• ThreadLocal.get() 就是拿当前线程 → 再从这个 map 里找对应 entry
• 不会引起锁竞争，空间换时间

经典使用场景

1. 数据库连接 / Session 绑定
   Spring 的 TransactionSynchronizationManager 把 Connection 放进 ThreadLocal，保证同一线程多次 DAO 调用用同一连接

2. 上下文传参
   日志 MDC（Mapped Diagnostic Context）、用户身份、traceId 等，避免层层方法传参

3. 线程安全的“日期格式化”
   SimpleDateFormat 非线程安全，可以为每个线程存一份：

   private static final ThreadLocal<DateFormat> DF =
           ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd"));
   

内存泄露

1. ThreadLocalMap 的 key 是弱引用，但 value 是强引用，线程池场景下线程复用，若忘记 remove()，value 一直存活 → 类加载器泄漏 → OOM
2. 黄金法则：用完 必须 remove()，尤其是线程池环境！