ThreadLocal 是 Java 中實現(xiàn)線程局部變量的重要工具，它能讓每個線程擁有自己獨立的變量副本，從而在多線程環(huán)境下避免共享數(shù)據(jù)的競爭問題。下面從作用、使用、實現(xiàn)原理、注意事項四個方面詳細(xì)說明。

1. 作用

• 線程隔離：每個線程通過同一個 ThreadLocal 對象存取數(shù)據(jù)時，實際操作的是各自線程內(nèi)部的存儲空間，互不干擾。
• 簡化并發(fā)：無需加鎖就能保證線程安全，適合存儲線程上下文信息。
• 避免參數(shù)傳遞：可以將一些公共信息（如用戶身份、事務(wù)連接、日志追蹤 ID）放入 ThreadLocal，在同一個線程的任意位置獲取，避免層層傳參。

2. 基本使用

// 創(chuàng)建 ThreadLocal 對象，可指定初始值
ThreadLocal<String> local = ThreadLocal.withInitial(() -> "default");
// 線程 A 中設(shè)置
local.set("valueA");
// 線程 B 中設(shè)置
local.set("valueB");
// 各自獲取
String a = local.get(); // 線程 A 得到 "valueA"
String b = local.get(); // 線程 B 得到 "valueB"
// 使用完后建議移除，避免內(nèi)存泄漏
local.remove();

常用方法：

• set(T value)：為當(dāng)前線程設(shè)置值。
• get()：獲取當(dāng)前線程的值，若未設(shè)置則返回初始值（通過 initialValue() 或 withInitial 指定）。
• remove()：移除當(dāng)前線程的值，釋放資源。
• initialValue()：初始化方法（一般通過 withInitial 或重寫該方法）。

3. 典型應(yīng)用場景

• 數(shù)據(jù)庫連接 / 事務(wù)管理：每個線程持有自己的 Connection 對象，確保事務(wù)隔離。
• 用戶會話 / 請求上下文：在 Web 應(yīng)用中，將用戶信息存入 ThreadLocal，同一請求的 Service、DAO 層可直接獲取。
• 線程安全的日期格式化：SimpleDateFormat 非線程安全，每個線程使用自己的實例。
• 日志追蹤 ID：為每個請求生成唯一 ID，存入 ThreadLocal，方便日志串聯(lián)。

4. 實現(xiàn)原理（核心）

ThreadLocal 的實現(xiàn)依賴于每個線程內(nèi)部的 ThreadLocalMap。

關(guān)鍵點：

• 每個線程對象（Thread）都有一個字段 threadLocals，類型為 ThreadLocalMap。
• ThreadLocalMap 是一個自定義的哈希表，其 Entry 的 key 是 ThreadLocal 實例的弱引用，value 是用戶存儲的值。
• 當(dāng)調(diào)用 set() 時，獲取當(dāng)前線程的 ThreadLocalMap，將當(dāng)前 ThreadLocal 對象作為 key，傳入值作為 value 存入。
• 當(dāng)調(diào)用 get() 時，同樣根據(jù)當(dāng)前線程的 Map 和當(dāng)前 ThreadLocal key 取出 value；若 Map 不存在則初始化，若 key 不存在則返回初始值。
• 由于 key 是弱引用，當(dāng) ThreadLocal 實例不再被強(qiáng)引用時，在 GC 時 key 會被回收，但 value 仍被 Entry 強(qiáng)引用，可能造成內(nèi)存泄漏。

源碼簡覽：

public void set(T value) {
    Thread t = Thread.currentThread();
    ThreadLocalMap map = getMap(t);
    if (map != null)
        map.set(this, value);
    else
        createMap(t, value);
}
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();
}

5. 注意事項與內(nèi)存泄漏

5.1 內(nèi)存泄漏風(fēng)險

• 原因：線程池中的線程會長期存活，如果 ThreadLocal 對象被回收（弱引用），但 Entry 中的 value 仍被線程的 ThreadLocalMap 強(qiáng)引用，導(dǎo)致 value 無法被回收，造成內(nèi)存泄漏。
• 表現(xiàn)：線程池中線程復(fù)用，長時間運行可能導(dǎo)致內(nèi)存占用持續(xù)增長。

5.2 解決方案

務(wù)必調(diào)用 remove() ：在線程執(zhí)行完任務(wù)后，顯式調(diào)用 remove() 清除當(dāng)前線程的變量。尤其在 Web 容器（如 Tomcat）中使用線程池時，必須養(yǎng)成習(xí)慣。

使用 try-finally 結(jié)構(gòu)：

try {
    local.set(value);
    // 業(yè)務(wù)邏輯
} finally {
    local.remove();
}

5.3 其他注意事項

• 線程池環(huán)境：由于線程會被復(fù)用，若未及時 remove()，下一個任務(wù)可能讀取到舊值，導(dǎo)致業(yè)務(wù)錯誤。
• 不恰當(dāng)?shù)氖褂?/strong>：避免用 ThreadLocal 傳遞大對象，增加內(nèi)存壓力。
• 父子線程傳遞：InheritableThreadLocal 可以實現(xiàn)子線程繼承父線程的值，但需謹(jǐn)慎使用。