什么是 ThreadLocal，如何实现的？

面试考察点

基本用法与场景：面试官不仅仅是想知道你用过 ThreadLocal，更是想看你能不能说出它的典型应用场景（数据库连接、Session 管理、日期格式化等），以及为什么不用加锁的方式。
底层实现原理：考察你是否理解 ThreadLocal 的数据结构设计——每个 Thread 对象内部持有一个 ThreadLocalMap，而不是 ThreadLocal 内部维护一个 Map<Thread, Value>。这个设计反转是面试的核心考点。
内存泄漏风险：能不能说清楚 ThreadLocal 为什么可能导致内存泄漏，WeakReference 在其中扮演什么角色，以及如何正确使用来避免问题。

核心答案

ThreadLocal 提供了线程本地变量，每个线程独立拥有一份变量副本，线程之间互不干扰，无需同步。

// 基本使用
private static final ThreadLocal<SimpleDateFormat> dateFormat =
    ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));

// 线程 A 获取到的是 A 自己的副本
// 线程 B 获取到的是 B 自己的副本
// 互不影响，无需加锁
String date = dateFormat.get().format(new Date());

核心原理：每个 Thread 对象内部有一个 ThreadLocalMap，ThreadLocal 的 get() / set() 操作其实是在操作当前线程自己的 ThreadLocalMap。

上图展示了 ThreadLocal 的存储结构。核心设计思路：

Map 在 Thread 里，不在 ThreadLocal 里：每个 Thread 对象持有一个 ThreadLocalMap，ThreadLocal 只是作为 key 去这个 Map 里存取数据。这样设计的好处是，每个线程只操作自己的 Map，天然线程安全，不需要任何同步措施。
Entry 的 key 是弱引用：ThreadLocalMap 的 Entry 继承了 WeakReference<ThreadLocal<?>>，key 对 ThreadLocal 对象是弱引用。这意味着当 ThreadLocal 对象没有被外部强引用时，GC 会回收它，对应的 Entry 的 key 会变成 null。
哈希冲突用开放地址法：ThreadLocalMap 和 HashMap 不同，它用 开放地址法（线性探测）解决哈希冲突，而不是链表/红黑树。原因是 ThreadLocal 的数量通常不多，开放地址法在数据量小的情况下更高效、缓存更友好。

深度解析

一、核心源码分析

set() 方法：

// ThreadLocal.set()
public void set(T value) {
    Thread t = Thread.currentThread();         // 获取当前线程
    ThreadLocalMap map = getMap(t);            // 获取当前线程的 ThreadLocalMap
    if (map != null)
        map.set(this, value);                  // this（ThreadLocal）作为 key
    else
        createMap(t, value);                   // 首次使用，创建 Map
}

// ThreadLocal.getMap()
ThreadLocalMap getMap(Thread t) {
    return t.threadLocals;                     // 直接返回 Thread 对象的字段
}

get() 方法：

// ThreadLocal.get()
public T get() {
    Thread t = Thread.currentThread();         // 获取当前线程
    ThreadLocalMap map = getMap(t);            // 获取当前线程的 Map
    if (map != null) {
        ThreadLocalMap.Entry e = map.getEntry(this);  // 以 this 为 key 查找
        if (e != null) {
            @SuppressWarnings("unchecked")
            T result = (T)e.value;
            return result;
        }
    }
    return setInitialValue();                  // 没找到，返回初始值
}

看到没？ThreadLocal 的 set() 和 get() 都是通过 Thread.currentThread() 拿到当前线程，然后操作当前线程内部的 ThreadLocalMap。ThreadLocal 本身不存储任何数据，它只是个 "钥匙"。

二、为什么 Map 放在 Thread 里？

面试官真正想听的是这个设计决策背后的原因。

如果放在 ThreadLocal 里（即 Map<Thread, Value>），多个线程同时操作同一个 ThreadLocal 时需要加锁，性能就上不去了。而把 Map 放在每个 Thread 里，每个线程只操作自己的 Map，完全无锁。这个设计确实优雅。

三、内存泄漏问题（高频考点）

这块是面试的重中之重。

上图展示了内存泄漏的产生过程。逐层拆解：

第一步：ThreadLocal 对象被外部设为 null（或者离开了作用域），此时栈上不再有对 ThreadLocal 的强引用。
第二步：因为 Entry 的 key 是 WeakReference，GC 时 ThreadLocal 对象被回收，Entry 的 key 变成 null。
第三步：但 value 仍然是强引用！而且 ThreadLocalMap 还存在于 Thread 对象中。只要线程不死，这个 key=null 的 Entry 就一直占着内存，无法被 GC 回收。这就是内存泄漏。
线程池场景更严重：线程池中的线程是复用的，不会销毁。如果 ThreadLocal 用完不 remove()，这些 key=null 的 Entry 会越积越多，最终导致 OOM。

如何避免？答案就一个字：remove()。

// 正确使用姿势
ThreadLocal<Connection> connHolder = new ThreadLocal<>();

try {
    connHolder.set(dataSource.getConnection());
    // 业务逻辑...
} finally {
    connHolder.remove();  // 用完必须 remove！
}

四、实际应用场景

场景	代码示例	为什么用 ThreadLocal
数据库连接管理	每个线程独立连接	避免连接共享导致的并发问题
Session 管理	`Session.setCurrentUser(user)`	每个 request 在独立线程中处理
日期格式化	`SimpleDateFormat` 线程不安全	避免每次 new 的开销，又不用加锁
链路追踪	`TraceId.set(traceId)`	全链路传递请求 ID
分页参数	`PageHelper.startPage()`	MyBatis 分页插件

Spring 框架中 ThreadLocal 用得非常多。比如 RequestContextHolder、TransactionSynchronizationManager、LocaleContextHolder，底层都是 ThreadLocal。面试时提一嘴 Spring 的应用，加分。

五、常见误区

误区 1：ThreadLocal 是用来解决共享对象同步问题的。

不是。ThreadLocal 的核心思想是 避免共享——每个线程各自持有一份副本，根本没有共享，也就不需要同步。它和 synchronized 解决的是不同层面的问题：synchronized 解决的是 "共享时的安全"，ThreadLocal 解决的是 "如何不共享"。

误区 2：ThreadLocal 不存在并发问题。

大部分情况下确实没有。但如果 ThreadLocal 里存的是对象引用，多个线程通过 ThreadLocal 拿到的初始值是同一个对象（比如 withInitial(() -> sharedObject)），那还是有并发问题。确保每个线程的副本是独立的。

面试高频追问

ThreadLocalMap 的 key 为什么要用弱引用？
- 如果用强引用，即使 ThreadLocal 对象设为 null，Entry 的 key 仍然持有强引用，ThreadLocal 对象永远无法被 GC，内存泄漏更严重。弱引用是一种 "妥协"——至少 ThreadLocal 对象本身能被回收，剩下的 value 通过 remove() 或清理逻辑来处理。
ThreadLocal 和 synchronized 的区别？
- synchronized 是 "共享加锁"，多个线程访问同一份数据，通过加锁保证安全。ThreadLocal 是 "避免共享"，每个线程各自持有一份数据副本，从根本上消除并发问题。思路完全不同。
线程池中使用 ThreadLocal 有什么注意事项？
- 必须在 finally 中调用 remove()。因为线程池中线程是复用的，上一个任务设置的 ThreadLocal 值会影响下一个任务，既可能导致数据错乱，又可能导致内存泄漏。

常见面试变体

"ThreadLocal 会导致内存泄漏吗？为什么？"
"ThreadLocal 的实现原理是什么？"
"为什么 ThreadLocalMap 的 key 是弱引用？"

记忆口诀

Map 在 Thread 里，ThreadLocal 当钥匙。用完一定 remove()，线程池中要牢记。

总结

面试答 ThreadLocal，三层递进：先说清楚它是线程本地变量、避免共享的思路，再从源码角度讲清楚 "Map 在 Thread 里" 的数据结构设计，最后重点展开内存泄漏的原因和解决方案。如果能把 Spring 中的应用场景也提一下，这道题基本满分。

发布于2026年01月12日|13:55:01