深度解析 ThreadLocal：其實就是一個 Map 的 Key

核心結論

ThreadLocal 不是儲存值的地方，它只是一個「鑰匙」。真正的倉庫是 Thread 內部的 ThreadLocalMap，Key 就是 ThreadLocal 實例本身。

源碼證據

// ThreadLocal.get()
public T get() {
    Thread t = Thread.currentThread();
    ThreadLocalMap map = getMap(t); // 取當前線程的 map
    if (map != null) {
        ThreadLocalMap.Entry e = map.getEntry(this); // this 即 ThreadLocal 實例作為 Key
        if (e != null) return (T)e.value;
    }
    return setInitialValue(); // 首次調用初始化
}

ThreadLocalMap getMap(Thread t) {
    return t.threadLocals; // Thread 類的私有字段
}

圖解存儲結構

假設當前線程 Thread@1 有 threadLocals = ThreadLocalMap@432：

1. firstNum.set(100) → Map 中 Key=ThreadLocal@428, Value=100
2. secondNum.set(200) → Map 中 Key=ThreadLocal@430, Value=200
3. thirdNum.set(300) → Map 中 Key=ThreadLocal@429, Value=300

關鍵屬性

• Thread.threadLocals：ThreadLocalMap，線程私有。
• ThreadLocalMap.Entry：繼承 WeakReference<ThreadLocal>，**Key 是弱引用**！

核心方法

為什麼 Key 用弱引用？

若 ThreadLocal 實例不再被外部引用，GC 可回收 Key，Map 中的 Entry 變為 key=null，下次 get/set/remove 會清理這些「陰影條目」，避免 Value 永遠無法釋放（內存洩漏）。但 Value 本身是強引用，若線程長期存活（如線程池），必須手動 remove()。

最佳實踐

1. static final 修飾 ThreadLocal 實例，確保 Key 唯一且長期可達。
2. try-finally 必配 remove()：

   private static final ThreadLocal<UserContext> CTX = new ThreadLocal<>();
   public void doSomething() {
       CTX.set(buildContext());
       try { businessLogic(); }
       finally { CTX.remove(); } // 釋放 Value，斷開引用鏈
   }

3. 不要在線程池任務間共享 ThreadLocal：線程復用會導致上一任務殘留數據污染下一任務。
4. InheritableThreadLocal：父線程值自動傳給子線程，但不支持線程池（池中線程非父子關系），需配合 TransmittableThreadLocal (阿里開源) 使用。

常見誤區

• ❌ ThreadLocal 存的是值 → ✅ 存的是「線程 → 值」的映射，ThreadLocal 只是 Key。
• ❌ ThreadLocal 解決線程安全 → ✅ 它提供線程隔離（各線程獨有副本），若值本身是可變對象並跨線程訪問，仍需同步。
• ❌ 不 remove 也沒事 → ✅ 線程池場景下會嚴重內存洩漏，且業務數據串聯。

總結

ThreadLocal = Key，Thread.threadLocals = Map，Entry.key = WeakReference(ThreadLocal)。理解這張圖，ThreadLocal 的所有行為（隔離、洩漏、繼承、清理）就都通透了。