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

1. 作用

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

2. 基本使用

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

常用方法：

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

3. 典型應用場景

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

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

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

關鍵點：

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

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

5.2 解決方案

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

使用 try-finally 結構：

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

5.3 其他注意事項

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