ThreadLocal 是 Java 中的一个非常重要的类，用于实现线程本地变量（Thread-local variable），即：

每个线程都有自己独立的变量副本，互不影响。

这在开发中非常有用，尤其适合解决多线程共享变量导致的数据冲突问题，比如：

• 数据库连接（如每个线程独享一个 Connection）；
• 用户会话信息；
• 格式化对象（如 SimpleDateFormat 线程不安全）；

---

一、ThreadLocal 是什么？

定义：

ThreadLocal 提供了线程局部变量，每个线程通过 ThreadLocal.get() 和 ThreadLocal.set() 访问属于它自己的变量副本。

---

二、典型使用示例

public class ThreadLocalExample {
    private static final ThreadLocal<Integer> threadLocal = ThreadLocal.withInitial(() -> 0);

    public static void main(String[] args) {
        Runnable task = () -> {
            int value = threadLocal.get();
            threadLocal.set(value + 1);
            System.out.println(Thread.currentThread().getName() + " value: " + threadLocal.get());
        };

        Thread t1 = new Thread(task);
        Thread t2 = new Thread(task);

        t1.start();
        t2.start();
    }
}

输出类似：

Thread-0 value: 1
Thread-1 value: 1

每个线程维护一份独立的值，互不干扰。

---

三、底层实现原理（详细分析）

关键点：

组成	作用
ThreadLocal	提供访问接口：set()、get()、remove()
Thread 类	每个线程维护一个 ThreadLocalMap 成员变量
ThreadLocalMap	实际是一个定制版的 HashMap，key 是 ThreadLocal 对象

---

1. 每个线程维护一个 ThreadLocalMap

// java.lang.Thread 源码
ThreadLocal.ThreadLocalMap threadLocals = null;

这是线程私有的变量容器。

---

2. 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；
• ThreadLocalMap 的 key 是当前的 ThreadLocal 实例本身；
• value 是用户存储的值。

---

3. get() 的底层逻辑

public T get() {
    Thread t = Thread.currentThread();
    ThreadLocalMap map = getMap(t);
    if (map != null) {
        ThreadLocalMap.Entry e = map.getEntry(this);
        if (e != null) {
            @SuppressWarnings("unchecked")
            T result = (T)e.value;
            return result;
        }
    }
    return setInitialValue();
}

每个线程只能获取自己的副本，不会影响其他线程。

---

4. ThreadLocalMap 的实现特点

• 本质是数组（类似 HashMap）；
• key 是 ThreadLocal 实例；
• 使用**弱引用（WeakReference）**作为 key；
• 如果 ThreadLocal 被 GC 回收而线程还在，可能出现 内存泄漏（value 无法访问但还未释放）；

官方建议（避免内存泄漏）：

• 用完后手动调用 remove() 清理

threadLocal.remove();

---

四、图解原理

Thread A:
  ThreadLocalMap:
    Key: ThreadLocal1  → Value: 100
    Key: ThreadLocal2  → Value: "abc"

Thread B:
  ThreadLocalMap:
    Key: ThreadLocal1  → Value: 200
    Key: ThreadLocal2  → Value: "xyz"

每个线程各自维护自己的 ThreadLocalMap，互相独立。

---

五、应用场景总结

场景	使用 ThreadLocal 的好处
多线程用户登录上下文	每个线程独立存储用户 session，不影响其他线程
数据库连接	每个线程一个 Connection，避免连接共享导致并发问题
日期格式化（SimpleDateFormat）	线程不安全的类，可以通过 ThreadLocal 为每线程提供独立实例
Spring AOP事务管理底层	使用 ThreadLocal 保存当前事务状态

---

六、替代方案与框架封装

✔ JDK 8+：

• ThreadLocal.withInitial(Supplier) 提供默认初始化方式

✔ Spring 封装：

• RequestContextHolder、TransactionSynchronizationManager 等都是基于 ThreadLocal 实现的

---

七、外部文献与链接

• 📘 官方 Java API 文档：
• ThreadLocal
• 📘 JDK 源码（OpenJDK）：
• ThreadLocal.java
• 📘 Java 并发实战书籍：
• 《Java Concurrency in Practice》：Brian Goetz（第3章）
• 📄 Martin Fowler 相关文章：
• Using ThreadLocal for Web Context

---

八、总结答题结构（面试/实战）

问题	回答要点
什么是 ThreadLocal？	每个线程独享的变量副本，解决线程间共享变量冲突
底层原理？	每个线程持有一个 ThreadLocalMap，key 是 ThreadLocal，value 是副本值
有什么使用风险？	使用弱引用容易内存泄漏，需手动调用 remove()
实际应用场景？	数据库连接、用户上下文、线程封装状态、格式化器等
框架是否使用？	Spring、MyBatis 等底层大量使用 ThreadLocal 管理上下文

---

更多详细内容请关注其他相关文章！