徹底理解 Java ThreadLocal：原理、模式對比與 Spring 實戰應用

什麼是 ThreadLocal？

ThreadLocal（線程局部變量）為每個線程提供獨立的變量副本，解決多線程環境下共享變量的並發衝突。JDK 1.2 引入，JDK 5.0 支持泛型 ThreadLocal<T>。

核心 API

• void set(T value)：設置當前線程副本值。
• T get()：獲取當前線程副本值。
• void remove()：刪除當前線程副本（加速 GC）。
• protected T initialValue()：子類覆蓋提供初始值，首次 get/set 時調用一次。

實戰示例：線程獨立序號生成器

public class TestNum {
    private static ThreadLocal<Integer> seqNum = new ThreadLocal<Integer>() {
        @Override protected Integer initialValue() { return 0; }
    };

    public int getNextNum() {
        seqNum.set(seqNum.get() + 1);
        return seqNum.get();
    }

    public static void main(String[] args) {
        TestNum sn = new TestNum();
        new Thread(() -> { for (int i=0;i<3;i++) System.out.println(Thread.currentThread().getName()+" -> "+sn.getNextNum()); }).start();
        new Thread(() -> { for (int i=0;i<3;i++) System.out.println(Thread.currentThread().getName()+" -> "+sn.getNextNum()); }).start();
        new Thread(() -> { for (int i=0;i<3;i++) System.out.println(Thread.currentThread().getName()+" -> "+sn.getNextNum()); }).start();
    }
}
// 輸出：每個線程獨立從 1 開始遞增，互不干擾

ThreadLocal vs synchronized 核心對比

源碼級原理剖析

1. Thread 中的 threadLocals

每個 Thread 實例內部持有 ThreadLocal.ThreadLocalMap threadLocals，Map 的 Key 是 ThreadLocal 對象本身，Value 是線程副本值。

2. set(T value) 流程

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 getMap(Thread t) { return t.threadLocals; }
void createMap(Thread t, T firstValue) { t.threadLocals = new ThreadLocalMap(this, firstValue); }

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) return (T) e.value;
    }
    return setInitialValue(); // 首次調用，執行 initialValue()
}

4. ThreadLocalMap 結構

• 基於開放地址法的哈希表，Entry 繼承 WeakReference<ThreadLocal>，Key 為弱引用。
• 防止 ThreadLocal 對象無法 GC，但 Value 強引用需手動 remove() 或線程結束釋放。

Spring 中的經典應用

Spring 將有狀態但需線程隔離的組件（RequestContextHolder、TransactionSynchronizationManager、LocaleContextHolder）封裝在 ThreadLocal 中，使其成為線程安全的單例 Bean，可安全注入多線程環境。

典型場景：DAO 共享同一事務 Connection

public class ConnectionManager {
    private static ThreadLocal<Connection> holder = new ThreadLocal<Connection>() {
        @Override protected Connection initialValue() {
            return DriverManager.getConnection(url, user, pass);
        }
    };
    public static Connection getConnection() { return holder.get(); }
    public static void setConnection(Connection conn) { holder.set(conn); }
}

// 事務管理器開啟事務時：ConnectionManager.setConnection(con);
// 多個 DAO 調用 ConnectionManager.getConnection() 獲取同一連接
// 事務結束：holder.remove();

最佳實踐與避坑指南

1. static final 修飾：ThreadLocal 實例通常聲明為靜態常量，避免重複創建。
2. 用完即 remove()：線程池場景下必須在 finally 塊調用 remove()，防止內存洩漏與數據串聯。
3. 不要在線程間傳遞 ThreadLocal：它綁定當前線程，跨線程無效。
4. InheritableThreadLocal：若需子線程繼承父線程值，使用此子類。

總結

ThreadLocal 以「空間換時間」實現無鎖線程隔離，是高併發系統中的利器。理解其 Thread → ThreadLocalMap → Entry(ThreadLocal, Value) 三層結構，掌握 set/get/remove 生命周期，結合 Spring 事務管理等實戰場景，即可靈活駕馭多線程狀態管理。