Java 多執行緒：同一執行緒跨方法傳值，ThreadLocal 實戰指南

問題場景

class A {
    new Thread(() -> {
        int a = 1;
        B b = new B();
        b.invokeB(a);
    });
}

class B {
    public void invokeB(int a) {
        C c = new C();
        c.invokeC(); // 這裡想用 a，但不想層層傳參
    }
}

class C {
    public void invokeC() {
        // 需要取得 a 的值
    }
}

開發者希望在同一執行緒的呼叫鏈 A → B → C 中，無需修改方法簽名即可取得變數 a。

為何直接傳參或靜態變數不可取？

• 層層傳參：汙染介面、違反單一職責，若呼叫鏈長達十層極難維護。
• 靜態變數：全域共享，多執行緒下會互相覆蓋，導致資料競爭與洩漏。

ThreadLocal 核心原理

ThreadLocal<T> 提供執行緒區域變數：每個執行緒持有獨立的副本，互不干擾。適用於「請求範圍」資料傳遞（如使用者 ID、追蹤 ID、資料庫連線）。

正確實作範例

public class ContextHolder {
    private static final ThreadLocal VALUE_HOLDER = new ThreadLocal<>();

    public static void set(Integer value) { VALUE_HOLDER.set(value); }
    public static Integer get() { return VALUE_HOLDER.get(); }
    public static void clear() { VALUE_HOLDER.remove(); } // 必須清理，防記憶體洩漏
}

class A {
    public void start() {
        new Thread(() -> {
            ContextHolder.set(1);           // 1. 寫入
            try {
                new B().invokeB();
            } finally {
                ContextHolder.clear();      // 3. 清理
            }
        }).start();
    }
}

class B {
    public void invokeB() { new C().invokeC(); }
}

class C {
    public void invokeC() {
        Integer a = ContextHolder.get();    // 2. 讀取
        System.out.println("取得值: " + a); // 輸出: 取得值: 1
    }
}

關鍵細節

1. static 修飾 ThreadLocal：確保類層級單例，避免重複建立。
2. finally 區塊清理：執行緒池重用時，若不 remove()，舊資料會殘留導致記憶體洩漏與業務錯誤。
3. 不可變物件：建議存放 Integer、String 等不可變型別，避免多處修改同一物件引發副作用。

進階替代方案

• InheritableThreadLocal：子執行緒自動繼承父執行緒值，適用於 new Thread(() -> ...) 場景。
• Reactive Context / ContextPropagator：Spring WebFlux、Project Reactor 原生支援跨非阻塞呼叫鏈傳遞。
• 結構化並行：Java 21+ StructuredTaskScope 讓值在作用域內自然流動，無需 ThreadLocal。

總結

ThreadLocal 是「同執行緒跨層傳值」的經典利器，但必須嚴格配對 set/remove，且僅適用於同步阻塞模型。現代專案建議優先評估框架內建的上下文傳遞機制，降低手動管理風險。