一、概念（What）
定义：
ThreadLocal 是 Java 提供的一种 线程局部变量（Thread Local Variable）机制。每个线程都维护一份变量的独立副本，线程之间互不干扰。
它不是用来解决多线程共享变量的问题，而是让每个线程有自己的专属副本。
典型作用：线程封闭（Thread Confinement），让某些变量在多线程环境下天然避免竞争。
一句话总结：ThreadLocal 提供了“为每个线程分配一个单独的变量副本”的能力。
二、核心原理（How）
1. 关键点
ThreadLocal 本身并不存储数据，而是作为 key，数据真正存储在 每个线程对象内部的 ThreadLocalMap 中。
每个 Thread 实例都有一个 ThreadLocal.ThreadLocalMap 成员。
ThreadLocalMap 的 key 是 ThreadLocal 实例本身（弱引用），value 是线程变量的副本。
2. 流程图（逻辑）
graph TD
A[Thread] --> B[ThreadLocalMap]
B --> C1["Entry: key = ThreadLocal (弱引用)\nvalue = Object"]
B --> C2["Entry: key = ThreadLocal (弱引用)\nvalue = Object"]
B --> C3["Entry: key = ThreadLocal (弱引用)\nvalue = Object"]
3. get/set 原理
set：ThreadLocal.set(value) → 获取当前线程 Thread.currentThread() → 找到其 threadLocals（ThreadLocalMap） → 以 ThreadLocal 实例作为 key 存入 value。
get：同理，取当前线程的 threadLocals，找到对应 entry 返回 value。
remove：删除当前线程的副本，避免内存泄漏。
4. 弱引用与内存泄漏问题
ThreadLocalMap.Entry 的 key 是对 ThreadLocal 的 弱引用（弱引用对象下一次 GC 就可能被清理）。
如果 ThreadLocal 实例被回收了，但线程还活着，value 还在，key 变成 null，这会导致 value 永远无法被访问，但仍被引用着 → 内存泄漏风险。
解决：在使用完毕后及时调用 remove()，尤其是在线程池环境中。
三、使用场景（When）
保存线程独享数据：每个线程有独立变量，不需要同步。
用户会话信息：如 web 请求过程中存放当前用户的登录信息。
数据库连接、事务管理：一个线程内共享同一个数据库连接，不同线程之间互不干扰。
线程上下文传递：如日志链路 ID、traceId。
四、示例代码
1. 基本用法
public class ThreadLocalDemo {
private static ThreadLocal
public static void main(String[] args) {
Runnable task = () -> {
int count = threadLocal.get();
threadLocal.set(count + 1);
System.out.println(Thread.currentThread().getName() + " : " + threadLocal.get());
};
new Thread(task, "A").start();
new Thread(task, "B").start();
}
}
输出示例：
A : 1
B : 1
两个线程各自维护一份独立的副本。
2. 在线程池中使用（重点）
private static ExecutorService pool = Executors.newFixedThreadPool(1);
private static ThreadLocal
public static void main(String[] args) {
pool.execute(() -> {
threadLocal.set("value1");
System.out.println(Thread.currentThread().getName() + " set value1");
});
pool.execute(() -> {
// 可能还会打印上次遗留的 value1（线程复用导致）
System.out.println(Thread.currentThread().getName() + " get " + threadLocal.get());
});
}
问题：线程池中的线程会被复用，如果不手动调用 remove()，可能造成脏数据或内存泄漏。
解决方案：在任务完成后调用 threadLocal.remove()，或用 阿里巴巴开源的 TransmittableThreadLocal。
五、源码分析（重点）
1. ThreadLocal.set()
public void set(T value) {
Thread t = Thread.currentThread();
ThreadLocalMap map = getMap(t);
if (map != null)
map.set(this, value);
else
createMap(t, value);
}
→ 实际是放到当前线程的 ThreadLocalMap 里。
2. ThreadLocalMap.Entry
static class Entry extends WeakReference
Object value;
Entry(ThreadLocal k, Object v) {
super(k);
value = v;
}
}
弱引用 key：避免 ThreadLocal 长生命周期 → 强引用导致内存泄漏。
value 强引用：如果 key 被回收，value 可能泄漏（“key=null, value=未清理”）。
3. 内存泄漏场景
线程池线程不销毁 → ThreadLocalMap 不销毁。
key 被 GC → value 残留 → 泄漏。
六、常见问题与坑
内存泄漏风险：线程池环境中必须手动 remove()。
跨线程传递失败：普通 ThreadLocal 无法在新线程中继承父线程的值（除非用 InheritableThreadLocal）。
并发场景误解：ThreadLocal 不是为了解决线程间共享问题，而是避免共享，达到线程封闭。
七、面试高频题 & 追问（含答案）
Q1：ThreadLocal 的原理是什么？
答：每个线程有一个 ThreadLocalMap，key 是 ThreadLocal，value 是该线程的副本。调用 set/get 时访问的是当前线程的 ThreadLocalMap，互不干扰。
追问：为什么 key 要用弱引用？
答：避免 ThreadLocal 对象本身长生命周期导致内存泄漏。如果不用弱引用，即使不再需要，GC 也无法回收 ThreadLocal。
Q2：为什么会发生内存泄漏？
答：当 ThreadLocal 实例被回收，key 变为 null，但 value 依然被线程持有。如果线程（尤其是线程池线程）还活着，value 就永远存在，造成泄漏。
追问：怎么解决？
答：及时调用 remove()；或者用一些框架（如阿里的 TransmittableThreadLocal）封装，确保任务执行完自动清理。
Q3：ThreadLocal 和 synchronized 的区别？
答：
synchronized：多个线程共享同一个变量，用锁保证可见性和互斥。
ThreadLocal：每个线程有自己独立的副本，不存在竞争问题。
追问：什么时候选 ThreadLocal，什么时候选锁？
答：如果是共享变量需要一致性 → 锁；如果是独立变量仅在线程内使用 → ThreadLocal。
Q4：InheritableThreadLocal 的作用？
答：它会把父线程中的 ThreadLocal 值复制到子线程中，常用于子线程需要继承父线程上下文（如 traceId）。
追问：线程池复用时为什么 InheritableThreadLocal 也会出问题？
答：因为线程池线程不是新建的，而是复用的，不会再次拷贝父线程的值，可能出现脏数据。解决方案是 TransmittableThreadLocal。
Q5：ThreadLocalMap 是如何解决哈希冲突的？
答：采用 线性探测法。当冲突时，继续往后找空位插入。查找时也会顺序往后找。
追问：这种方式的缺点是什么？
答：在冲突多时性能下降（O(n) 查找）。但 ThreadLocalMap 主要用于单线程存少量数据，冲突不严重。
Q6：ThreadLocal 是如何被 GC 的？
答：
key：弱引用，GC 时会被清理。
value：强引用，如果不 remove，则会残留。
所以 ThreadLocal 机制依赖用户主动清理。
八、最佳实践
避免把大对象放入 ThreadLocal，容易加大内存泄漏影响。
使用完毕后调用 remove()，尤其是线程池环境。
不要误用 ThreadLocal 代替线程安全机制，它的作用是线程隔离而不是同步。
封装 ThreadLocal（例如工具类，统一 set/get/remove）。
九、总结一句话
ThreadLocal 不是用来解决多线程共享问题，而是用来让变量 线程隔离。用不好容易内存泄漏，用得好能简化上下文传递和线程安全问题。