ThreadLocal原理

ThreadLocal是什么

早在JDK 1.2的版本中就提供Java.lang.ThreadLocal,ThreadLocal为解决多线程程序的并发问题提供了一种新的思路。使用这个工具类可以很简洁地编写出优美的多线程程序。


当使用ThreadLocal维护变量时,ThreadLocal为每个使用该变量的线程提供独立的变量副本,所以每一个线程都可以独立地改变自己的副本,而不会影响其它线程所对应的副本。

从线程的角度看,目标变量就象是线程的本地变量,这也是类名中“Local”所要表达的意思。所以,在Java中编写线程局部变量的代码相对来说要笨拙一些,因此造成线程局部变量没有在开发者中得到很好的普及。


ThreadLocal的方法

ThreadLocal类很简单,只有4个方法,我们先来了解一下:

  • void set(Object value) 设置当前线程的线程局部变量的值。
  • public Object get() 该方法返回当前线程所对应的线程局部变量。
  • public void remove() 将当前线程局部变量的值删除,目的是为了减少内存的占用,该方法是JDK 5.0新增的方法。需要指出的是,当线程结束后,对应该线程的局部变量将自动被垃圾回收,所以显式调用该方法清除线程的局部变量并不是必须的操作,但它可以加快内存回收的速度。
  • protected Object initialValue() 返回该线程局部变量的初始值,该方法是一个protected的方法,显然是为了让子类覆盖而设计的。这个方法是一个延迟调用方法,在线程第1次调用get()或set(Object)时才执行,并且仅执行1次。ThreadLocal中的缺省实现直接返回一个null。

值得一提的是,在JDK5.0中,ThreadLocal已经支持泛型,该类的类名已经变为ThreadLocal。API方法也相应进行了调整,新版本的API方法分别是void set(T value)、T get()以及T initialValue()。


ThreadLocal的使用

ThreadLocal是如何做到为每一个线程维护变量的副本的呢?其实实现的思路很简单:在ThreadLocal类中有一个Map,用于存储每一个线程的变量副本,Map中元素的键为线程对象,而值对应线程的变量副本。我们自己就可以提供一个简单的实现版本:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
public class TestNum {
// ①通过匿名内部类覆盖ThreadLocal的initialValue()方法,指定初
public static ThreadLocal<Integer> seqNum = new ThreadLocal<Integer>() {
@Override
protected Integer initialValue() {
return 0;
}
}
// ②获取下一个序列值
public int getNextInt() {
seqNum.set(seqNum.get() + 1);
return seqNum.get();
}
// ③3个线程共享sn,各自产生序列号测试
public static void main(String[] args) {
TestNum sn = new TestNum();
TestClient t1 = new TestClient(sn);
TestClient t2 = new TestClient(sn);
TestClient t3 = new TestClient(sn);
t1.start();
t2.start();
t3.start();
}
}

class TestClient extends Thread {
private TestNum sn;

public TestClient(TestNum sn) {
this.sn = sn;
}
@Override
public void run() {
for (int i=0; i<3; i++) {
// ④每个线程打出3个序列值
System.out.println(Thread.currentThread().getName() + "----> sn:" + sn.getNextInt());
}
}
}

//运行结果
Thread-0----> sn:1
Thread-2----> sn:1
Thread-1----> sn:1
Thread-2----> sn:2
Thread-0----> sn:2
Thread-2----> sn:3
Thread-1----> sn:2
Thread-0----> sn:3
Thread-1----> sn:3

我们发现每个线程所产生的序号虽然都共享同一个TestNum实例,但它们并没有发生相互干扰的情况,而是各自产生独立的序列号,这是因为我们通过ThreadLocal为每一个线程提供了单独的副本。


ThreadLocal和线程同步机制比较

ThreadLocal和线程同步机制都是为了解决多线程中相同变量的访问冲突问题。

在线程同步机制中,通过对象的锁机制保证同一时间只有一个线程访问变量。这时该变量是多个线程共享的,使用同步机制要求程序慎密地分析什么时候对变量进行读写,什么时候需要锁定某个对象,什么时候释放对象锁等繁杂的问题,程序设计和编写难度相对较大。而ThreadLocal则从另一个角度来解决多线程的并发访问。ThreadLocal会为每一个线程提供一个独立的变量副本,从而隔离了多个线程对数据的访问冲突。因为每一个线程都拥有自己的变量副本,从而也就没有必要对该变量进行同步了。ThreadLocal提供了线程安全的共享对象,在编写多线程代码时,可以把不安全的变量封装进ThreadLocal。

概括起来说,对于多线程资源共享的问题,同步机制采用了“以时间换空间”的方式,而ThreadLocal采用了“以空间换时间”的方式。前者仅提供一份变量,让不同的线程排队访问,而后者为每一个线程都提供了一份变量,因此可以同时访问而互不影响。

Spring使用ThreadLocal解决线程安全问题。我们知道在一般情况下,只有无状态的Bean才可以在多线程环境下共享,在Spring中,绝大部分Bean都可以声明为singleton作用域。就是因为Spring对一些Bean(如RequestContextHolder、TransactionSynchronizationManager、LocaleContextHolder等)中非线程安全状态采用ThreadLocal进行处理,让它们也成为线程安全的状态,所以有状态的Bean就可以在多线程中共享了。

一般的Web应用划分为展现层、服务层和持久层三个层次,在不同的层中编写对应的逻辑,下层通过接口向上层开放功能调用。在一般情况下,从接收请求到返回响应所经过的所有程序调用都同属于一个线程,如图一所示:

同一线程贯通三层这样你就可以根据需要,将一些非线程安全的变量以ThreadLocal存放,在同一次请求响应的调用线程中,所有关联的对象引用到的都是同一个变量。

下面的实例能够体现Spring对有状态Bean的改造思路:

非线程安全conn:

1
2
3
4
5
6
7
8
9
10
11
12
import java.sql.Connection;  
import java.sql.SQLException;
import java.sql.Statement;

public class TestDao {
private Connection conn;// ①一个非线程安全的变量

public void addTopic() throws SQLException {
Statement stat = conn.createStatement();// ②引用非线程安全变量
// …
}
}

线程安全conn:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import java.sql.Connection;  
import java.sql.SQLException;
import java.sql.Statement;

public class TestDaoNew {
// ①使用ThreadLocal保存Connection变量
private static ThreadLocal<Connection> connThreadLocal = new ThreadLocal<Connection>();

public static Connection getConnection() {
// ②如果connThreadLocal没有本线程对应的Connection创建一个新的Connection,
// 并将其保存到线程本地变量中。
if (connThreadLocal.get() == null) {
Connection conn = Conn.getNewConnection();
connThreadLocal.set(conn);
return conn;
} else {
return connThreadLocal.get();// ③直接返回线程本地变量
}
}
public void addTopic() throws SQLException {
// ④从ThreadLocal中获取线程对应的Connection
Statement stat = getConnection().createStatement();
}
}

不同的线程在使用TopicDao时,先判断connThreadLocal.get()是否是null,如果是null,则说明当前线程还没有对应的Connection对象,这时创建一个Connection对象并添加到本地线程变量中;如果不为null,则说明当前的线程已经拥有了Connection对象,直接使用就可以了。这样,就保证了不同的线程使用线程相关的Connection,而不会使用其它线程的Connection。因此,这个TopicDao就可以做到singleton共享了。

当然,这个例子本身很粗糙,将Connection的ThreadLocal直接放在DAO只能做到本DAO的多个方法共享Connection时不发生线程安全问题,但无法和其它DAO共用同一个Connection,要做到同一事务多DAO共享同一Connection,必须在一个共同的外部类使用ThreadLocal保存Connection。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
import java.sql.Connection;  
import java.sql.DriverManager;
import java.sql.SQLException;

public class ConnectionManager {

//初始化
private static ThreadLocal<Connection> connectionHolder =
new ThreadLocal<Connection>() {
@Override
protected Connection initialValue() {
Connection conn = null;
try {
JdbcConfig jdbcConfig=XmlConfigReader.GetInstance().getJdbcConfig();
Class.forName(jdbcConfig.getDriverName());
conn=DriverManager.jdbcConfig.getUserName(),jdbcConfig.getPassword());
} catch (SQLException e) {
e.printStackTrace();
}
return conn;
}
};

//获取连接
public static Connection getConnection() {
return connectionHolder.get();
}
//将连接放入局部线程变量
public static void setConnection(Connection conn) {
connectionHolder.set(conn);
}
//关闭连接
public static void closeConnection() {
Connection conn = connectionHolder.get();
if (conn != null) {
try {
conn.close();
//从ThreadLocal中清除Connection
connectionHolder.remove();
} catch (SQLException e) {
e.printStackTrace();
}
}
}
//关闭Statement(用于执行静态 SQL 语句并返回它所生成结果的对象。)
public static void close(Statement pstmt) {
if (pstmt != null) {
try {
pstmt.close();
} catch (SQLException e) {
e.printStackTrace();
}
}
}
//关闭结果集
public static void close(ResultSet rs ) {
if (rs != null) {
try {
rs.close();
} catch (SQLException e) {
e.printStackTrace();
}
}
}
//开启事务
public static void beginTransaction(Connection conn) {
try {
if (conn != null) {
if (conn.getAutoCommit()) {
conn.setAutoCommit(false); //手动提交
}
}
}catch(SQLException e) {}
}
//提交事务
public static void commitTransaction(Connection conn) {
try {
if (conn != null) {
if (!conn.getAutoCommit()) {
conn.commit();
}
}
}catch(SQLException e) {}
}
//回滚事务
public static void rollbackTransaction(Connection conn) {
try {
if (conn != null) {
if (!conn.getAutoCommit()) {
conn.rollback();
}
}
}catch(SQLException e) {}
}
}


ThreadLocal的实现原理

那么到底ThreadLocal类是如何实现这种“为每个线程提供不同的变量拷贝”的呢?先来看一下ThreadLocal的set()方法的源码是如何实现的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/** 
* Sets the current thread's copy of this thread-local variable
* to the specified value. Most subclasses will have no need to
* override this method, relying solely on the {@link #initialValue}
* method to set the values of thread-locals.
* @param value the value to be stored in the current thread's copy of this thread-local.
*/
public void set(T value) {
Thread t = Thread.currentThread();
ThreadLocalMap map = getMap(t);
if (map != null)
map.set(this, value);
else
createMap(t, value);
}

在这个方法内部我们看到,首先通过getMap(Thread t)方法获取一个和当前线程相关的ThreadLocalMap,然后将变量的值设置到这个ThreadLocalMap对象中,当然如果获取到的ThreadLocalMap对象为空,就通过createMap方法创建。

线程隔离的秘密,就在于ThreadLocalMap这个类。ThreadLocalMap是ThreadLocal类的一个静态内部类,它实现了键值对的设置和获取(对比Map对象来理解),每个线程中都有一个独立的ThreadLocalMap副本,它所存储的值,只能被当前线程读取和修改。ThreadLocal类通过操作每一个线程特有的ThreadLocalMap副本,从而实现了变量访问在不同线程中的隔离。因为每个线程的变量都是自己特有的,完全不会有并发错误。还有一点就是,ThreadLocalMap存储的键值对中的键是this对象指向的ThreadLocal对象,而值就是你所设置的对象了。

为了加深理解,我们接着看上面代码中出现的getMap和createMap方法的实现:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/** 
* Get the map associated with a ThreadLocal. Overridden in
* InheritableThreadLocal.
* @param t the current thread
* @return the map
*/
ThreadLocalMap getMap(Thread t) {
return t.threadLocals;
}

/**
* Create the map associated with a ThreadLocal. Overridden in
* InheritableThreadLocal.
* @param t the current thread
* @param firstValue value for the initial entry of the map
* @param map the map to store.
*/
void createMap(Thread t, T firstValue) {
t.threadLocals = new ThreadLocalMap(this, firstValue);
}

接下来再看一下ThreadLocal类中的get()方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/** 
* Returns the value in the current thread's copy of this
* thread-local variable. If the variable has no value for the
* current thread, it is first initialized to the value returned
* by an invocation of the {@link #initialValue} method.
* @return the current thread's value of this thread-local
*/
public T get() {
Thread t = Thread.currentThread();
ThreadLocalMap map = getMap(t);
if (map != null) {
ThreadLocalMap.Entry e = map.getEntry(this);
if (e != null)
return (T)e.value;
}
return setInitialValue();
}

再来看setInitialValue()方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/** 
* Variant of set() to establish initialValue. Used instead
* of set() in case user has overridden the set() method.
* @return the initial value
*/
private T setInitialValue() {
T value = initialValue();
Thread t = Thread.currentThread();
ThreadLocalMap map = getMap(t);
if (map != null)
map.set(this, value);
else
createMap(t, value);
return value;
}

获取和当前线程绑定的值时,ThreadLocalMap对象是以this指向的ThreadLocal对象为键进行查找的,这当然和前面set()方法的代码是相呼应的。

进一步地,我们可以创建不同的ThreadLocal实例来实现多个变量在不同线程间的访问隔离,为什么可以这么做?因为不同的ThreadLocal对象作为不同键,当然也可以在线程的ThreadLocalMap对象中设置不同的值了。通过ThreadLocal对象,在多线程中共享一个值和多个值的区别,就像你在一个HashMap对象中存储一个键值对和多个键值对一样,仅此而已。

原理图

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
┌─────────────────────────────────────────────────────────────────────┐
│ JVM Process │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ┌────────────────────┐ │
│ │ Thread A │ ┌────────────────────┐ │
│ │ │ │ Thread B │ │
│ │ ┌───────────────┐ │ │ ┌──────────────┐ │ │
│ │ │ ThreadLocal │ │ │ │ ThreadLocal │ │ │
│ │ │ .ThreadLocals │──┐ │ │ .ThreadLocals│──┐ │
│ │ │ (threadLocals)│ │ │ │(threadLocals)│ │ │
│ │ └──────┬────────┘ │ │ └──────┬───────┘ │ │
│ │ │ │ │ │ │ │
│ │ ┌──────▼────────┐ │ │ ┌──────▼───────┐ │ │
│ │ │ ThreadLocalMap│ │ │ │ThreadLocalMap│ │ │
│ │ │ │ │ │ │ │ │ │
│ │ │ ┌──────────┐ │ │ │ │ ┌──────────┐ │ │ │
│ │ │ │Entry[0] │ │ │ │ │ │Entry[0] │ │ │ │
│ │ │ │key=TL1 │ │ │ │ │ │key=TL1 │ │ │ │
│ │ │ │value=V1 │ │ │ │ │ │value=Vx │ │ │ │
│ │ │ └──────────┘ │ │ │ │ └──────────┘ │ │ │
│ │ │ ┌──────────┐ │ │ │ │ ┌──────────┐ │ │ │
│ │ │ │Entry[1] │ │ │ │ │ │Entry[1] │ │ │ │
│ │ │ │key=TL2 │ │ │ │ │ │key=TL2 │ │ │ │
│ │ │ │value=V2 │ │ │ │ │ │value=Vy │ │ │ │
│ │ │ └──────────┘ │ │ │ │ └──────────┘ │ │ │
│ │ │ ... │ │ │ │ ... │ │ │
│ │ └───────────────┘ │ │ └──────────────┘ │ │
│ └─────────────────────┘ └────────────────────┘ │
│ │ │ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────────────────────────────────────┐ │
│ │ ThreadLocal 实例(全局) │ │
│ │ static ThreadLocal<User> tl = new ... │ │
│ │ static ThreadLocal<Conn> tl2 = new ... │ │
│ └─────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘

Thread 类里的字段:每个 Thread 对象内部持有一个 ThreadLocalMap,这个 Map 不是 java.util.Map,是 ThreadLocal 的静态内部类。

1
2
// java.lang.Thread
ThreadLocal.ThreadLocalMap threadLocals = null;

ThreadLocalMap 的内部结构:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
┌───────────────────────────────────────────────┐
│ ThreadLocalMap │
│ │
│ Entry[] table (开放地址法哈希表) │
│ │
│ ┌───────────────────────────────────┐ │
│ │ Entry extends WeakReference<ThreadLocal<?>> │
│ │ │ │
│ │ key → ThreadLocal 实例 (弱引用) │ │
│ │ value → 实际存储的对象 (强引用) │ │
│ └───────────────────────────────────┘ │
│ │
│ table[0] → Entry(key=tl1, value=A) │
│ table[1] → null │
│ table[2] → Entry(key=tl2, value=B) │
│ table[3] → Entry(key=tl3, value=C) │
│ ... │
└────────────────────────────────────────────────┘

Entry 的继承关系:

1
2
3
4
Entry
└── WeakReference<ThreadLocal<?>>
├── referent → ThreadLocal 实例(弱引用,GC 可回收)
└── value → 实际值(强引用,必须手动 remove 才能释放)

threadLocal.set(value) 调用链:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
ThreadLocal.set(value)
│
▼
Thread.currentThread()
│
▼
Thread.threadLocals (ThreadLocalMap)
│
▼
ThreadLocalMap.set(ThreadLocal<?> key, Object value)
│
▼
计算 hash → 定位 table 数组下标 i
│
├── 无冲突 → table[i] = new Entry(key, value)
├── 有冲突 → 线性探测下一个位置
└── 发现 stale entry → 清理并复用

threadLocal.get() 调用链:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
ThreadLocal.get()
│
▼
Thread.currentThread()
│
▼
Thread.threadLocals
│
▼
ThreadLocalMap.getEntry(ThreadLocal<?> key)
│
▼
hash → table[i] → 比较 key
│
├── 命中 → 返回 entry.value
├── key 不匹配 → 线性探测继续找
└── 未找到 → setInitialValue() → 返回 initialValue()

关键的内存引用关系图

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
┌──────────────────┐
│ static 变量 │
│ ThreadLocal tl │──┐ (强引用)
└──────────────────┘ │
▼
┌────────────────┐
│ ThreadLocal │ ← GC Root 可达
│ 实例 │
└───────┬────────┘
│ 弱引用 (referent)
┌───────▼─────────┐
│ Entry (table[i])│
│ key ───────────┘
│ value ───────────────────────┐
└───────────────────────────────┘
│ 强引用
┌───────▼────────┐
│ 实际业务对象 │
│ (User/Conn..) │
└────────────────┘

Thread Ref → Thread 对象 → ThreadLocalMap → Entry[] → value (强引用链)

内存泄漏原理图:

不调用 remove() 时的引用链

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
情况:ThreadLocal 实例不再被外部引用(比如 tl = null)

GC 发生:
key (弱引用) → 被 GC 回收 → key = null

但:
Entry 本身还在 table 里
value (强引用) → 业务对象 → 无法被 GC

结果:
table[i] = Entry(key=null, value=大对象)
→ 内存泄漏!直到线程销毁才释放


┌──────────────┐
│ Thread 对象 │
│ (线程池复用) │ ← 线程不销毁!
└──────┬───────┘
│
▼
┌───────────────────────┐
│ ThreadLocalMap │
│ │
│ table[i] = Entry │
│ key = null ✅ GC │ ← key 被弱引用回收了
│ value = 大对象 ❌ │ ← value 强引用,泄漏!
└───────────────────────┘

所以总结起来:ThreadLocal 不是把数据存在 ThreadLocal 里,而是每个 Thread 自己维护一个 Map,用 ThreadLocal 实例作为 key 去存取。

  • 数据存在哪:Thread.threadLocals(每个线程一份)
  • key 是什么:ThreadLocal 实例本身
  • 线程隔离原理:数据在各自 Thread 的 Map 里,互不可见
  • 哈希冲突解决:开放地址法(线性探测)
  • key 为什么弱引用:防止 ThreadLocal 实例本身泄漏
  • value 为什么需 remove:防止线程池场景下 value 永远不释放


什么是强弱引用?

先搞懂:什么叫”引用”?

1
Object a = new Object();

这行代码做了两件事:

  • new Object() → 在堆内存里创建了一块空间,放着一个对象
  • a → 是一个引用变量,存在栈里,它指向那块内存
1
2
3
4
5
栈                    堆
┌───┐ ┌──────────┐
│ a │ ───────────▶ │ Object │
└───┘ └──────────┘
引用 实际对象

“引用”就是一根绳子,拴着一块内存。你平时写的每一行代码,默认都是强引用:

1
User user = new User("张三");
1
2
3
4
5
栈             堆
┌──────┐ ┌──────────────┐
│ user │ ──▶ │ User("张三") │
└──────┘ └──────────────┘
强引用 实际对象

强引用的规则只有一条:只要有一根强引用绳子拴着,GC(垃圾回收器)就绝对不敢回收这块内存。哪怕你内存快爆了,GC 宁可抛 OutOfMemoryError,也不会回收有强引用指向的对象。

1
2
3
4
5
6
# user = null;  // 把绳子剪断

栈 堆
┌──────┐ ┌──────────────┐
│ user │ × │ User("张三") │ ← 没有绳子拴了
└──────┘ └──────────────┘ GC 下次扫到就回收

弱引用就是一根”纸绳子”:

1
WeakReference<User> weakUser = new WeakReference<>(new User("李四"));
1
2
3
4
5
栈                   堆
┌──────────┐ ┌──────────────────┐ ┌─────────────┐
│ weakUser │ ──▶ │ WeakReference │ ──▶ │ User("李四") │
└──────────┘ └──────────────────┘ └─────────────┘
弱引用包装器 纸绳子 实际对象

弱引用的规则:只要 GC 一运行,不管内存够不够,只要这个对象只被弱引用拴着,直接回收。用一段代码感受区别:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public static void main(String[] args) {
// 强引用
User strong = new User("张三");
// 弱引用
WeakReference<User> weak = new WeakReference<>(new User("李四"));

System.out.println("GC 前:");
System.out.println("strong = " + strong.getName()); // 张三
System.out.println("weak = " + weak.get()); // 李四(还活着)

// 触发 GC
System.gc();

System.out.println("GC 后:");
System.out.println("strong = " + strong.getName()); // 张三(还活着)
System.out.println("weak = " + weak.get()); // null!被收走了
}

为什么李四没了?因为 new User(“李四”) 创建出来后,唯一的强引用就是 WeakReference 构造函数里的临时引用,方法调用完就没了。只剩 WeakReference 这根纸绳子拴着 → GC 一来,直接收走 → weak.get() 返回 null。

张三为什么还在?因为 strong 变量是强引用,铁链没剪断,GC 不敢动。

回到 ThreadLocal:为什么 key 要用弱引用?ThreadLocalMap 里的 Entry 长这样:

1
2
3
4
5
6
7
8
static class Entry extends WeakReference<ThreadLocal<?>> {
Object value; // 强引用

Entry(ThreadLocal<?> k, Object v) {
super(k); // key 是弱引用 → 纸绳子
value = v; // value 是强引用 → 铁链
}
}

内存里的引用关系:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
场景:static ThreadLocal<User> tl = new ThreadLocal<>();
tl.set(new User("张三"));

引用链:

栈 堆
┌────────┐ ┌─────────────────┐
│ tl │ ──强引用──▶ │ ThreadLocal实例 │
└────────┘ └────────┬────────┘
│ 弱引用 (纸绳)
┌───────▼─────────┐
│ Entry │
│ key ───────────┘
│ value ──────────────▶ User("张三")
└────────────────┘

关键问题:如果 key 是强引用会怎样?假设你把 tl = null(不再需要这个 ThreadLocal 了):

1
2
3
4
5
6
7
8
9
10
栈                       堆
┌────────┐ ┌────────────────┐
│ tl │ × 断了 │ ThreadLocal实例 │
└────────┘ └───────┬────────┘
│ 强引用 (铁链!)
┌───────▼─────────┐
│ Entry │
│ key ───────────┘
│ value ──────────────▶ User("张三")
└────────────────┘

tl 断了 → 但你以为 ThreadLocal 实例可以回收了,不!Entry 的 key 是强引用 → ThreadLocal 实例还被拴着 → 回收不了,Entry 也回收不了 → value 也回收不了,内存泄漏,永久泄漏,直到线程死!如果 key 是弱引用呢?

1
2
3
4
5
6
7
8
9
10
11
12
tl = null 之后,GC 一来:

栈 堆
┌────────┐ ┌────────────────┐
│ tl │ × │ ThreadLocal实例 │ ← GC 回收!纸绳断了
└────────┘ └────────────────┘

┌─────────────────┐
│ Entry │
│ key = null ✅ │ ← key 被 GC 收走了
│ value ──────────────▶ User("张三")
└─────────────────┘
  • ThreadLocal 实例被回收了 ✅
  • Entry 的 key 变成 null ✅
  • 但 value 还在!(强引用铁链没断)
  • 所以 value 还是会泄漏?对,但程度轻多了!

弱引用在这里是 “兜底设计”:至少让 key 那一层不会泄漏,value 那一层靠你调用 remove() 来释放。