Java ThreadLocal 設計原理與實戰應用：執行緒區域變數完整指南

設計動機

解決多執行緒共享變數衝突，採用空間換時間：每執行緒獨享副本，無需同步。

核心 API

public class ThreadLocal {
    // 取得當前執行緒的值，首次呼叫觸發 initialValue()
    public T get() { ... }
    
    // 設定當前執行緒的值
    public void set(T value) { ... }
    
    // 移除當前執行緒的值 (防洩漏)
    public void remove() { ... }
    
    // 子類別覆寫提供初始值
    protected T initialValue() { return null; }
}

內部實作：ThreadLocalMap

// Thread 內部
ThreadLocal.ThreadLocalMap threadLocals;

// ThreadLocalMap 簡化結構
static class ThreadLocalMap {
    static class Entry extends WeakReference> {
        Object value;
        Entry(ThreadLocal k, Object v) { super(k); value = v; }
    }
    private Entry[] table;
    // 開放定址法處理碰撞
}

Key 為 ThreadLocal 弱參考，Value 為強參考。

標準使用模式：靜態 ThreadLocal + 靜態存取方法

public class RequestIdGenerator {
    private static final ThreadLocal holder = new ThreadLocal() {
        @Override protected Long initialValue() {
            return System.nanoTime(); // 每執行緒獨立初始值
        }
    };
    
    public static long get() { return holder.get(); }
    public static void set(long id) { holder.set(id); }
    public static void clear() { holder.remove(); }
}

五大實戰應用場景

InheritableThreadLocal：父子執行緒傳遞

InheritableThreadLocal context = new InheritableThreadLocal<>();
context.set("parent-value");
// 新 Thread 會自動複製父執行緒的值
new Thread(() -> System.out.println(context.get())).start();
// 輸出: parent-value

注意：執行緒池重用執行緒時，父子關係不適用，需手動清理。

記憶體洩漏風險與防範

• 原因：執行緒池重用 → ThreadLocalMap 殘留強參考 → GC 無法回收 Key/Value
• 鐵律：finally { threadLocal.remove(); }
• 檢測：JVM 參數 -Djava.lang.ThreadLocal.verbose=true (部分實作支援)

Java 20+ Scoped Values：結構化並發新選擇

// 不可變、自動生命週期、巢狀作用域
static final ScopedValue CURRENT_USER = ScopedValue.newInstance();

void handleRequest(Request req) {
    User user = authenticate(req);
    ScopedValue.runWhere(CURRENT_USER, user, () -> {
        // 此作用域內所有子執行緒 (StructuredTaskScope) 可見
        processBusinessLogic();
    });
    // 離開作用域自動清理，無洩漏風險
}

1. 上一篇文章： Java 多執行緒核心方法完整解析：run/start、sleep、join、yield、wait/notify
2. 下一篇文章： Java 執行緒模型缺陷深度分析：Allen Holub 的改革建議與現代解決方案

Java 相關知識

JSR 286 Portlet 新特性，第 3 部分

在本系列的第 1 部分簡要回顧了 JSR 168 Portl

Git 連線加速實戰：SSH 多路複用讓 push/pull 提速 5 倍

痛點：Git 遠端操作緩慢？ Git 雖擁有本地倉庫優勢，但

Struts 2 MVC 框架架構深度解析：從組件模型到 BBS 實戰案例

Struts 2 架構核心：標準 MVC 映射 MVC

HashMap 底層原理深度解析：數據結構、存取流程、擴容機制與性能優化

前言：HashMap 的核心地位 HashMap 是 Jav