Java ThreadLocal 深度解析：線程隔離變量的實現原理與最佳實踐

核心價值

ThreadLocal 提供**線程局部變量**：同一代碼路徑，不同線程訪問互不干擾的獨立副本。典型場景：

• 數據庫連接/事務上下文傳遞（Spring TransactionSynchronizationManager）
• 用戶身份/請求上下文（RequestContextHolder）
• 非線程安全對象的線程獨享（SimpleDateFormat、Random）

手寫簡易版理解原理

public class SimpleThreadLocal<T> {
    private final Map<Thread, T> map = new WeakHashMap<>();

    public void set(T value) {
        map.put(Thread.currentThread(), value);
    }

    public T get() {
        return map.get(Thread.currentThread());
    }

    public void remove() {
        map.remove(Thread.currentThread());
    }
}

本質：Thread 內部持有 ThreadLocalMap（Key 為 ThreadLocal 弱引用，Value 為對象強引用）。set/get 實際操作當前線程的 Map。

JDK 實現關鍵點

• ThreadLocalMap.Entry extends WeakReference<ThreadLocal>：Key 弱引用，防止 ThreadLocal 對象無法回收。
• 內存洩漏風險：線程池線程長期存活，若不調用 remove()，Value 強引用導致對象殘留。最佳實踐：用完即刪，try-finally 保證清理。
• 哈希衝突處理：開放地址法，步長 nextIndex = (i + 1) & (len - 1)，擴容閾值 2/3。
• InheritableThreadLocal：子線程自動複製父線程值，基於 Thread.init() 複製 inheritableThreadLocals。

實戰封裝：上下文持有者模式

public final class UserContextHolder {
    private static final ThreadLocal<UserContext> TL = new ThreadLocal<>();

    private UserContextHolder() {}

    public static void set(UserContext ctx) {
        TL.set(ctx);
    }

    public static UserContext get() {
        return TL.get();
    }

    public static void clear() {
        TL.remove();
    }

    // 業務代碼
    public void processOrder(Order order) {
        UserContext ctx = UserContextHolder.get();
        // 直接使用 ctx.getUserId()，無需層層傳參
        orderService.create(order, ctx.getUserId());
    }
}

// Filter/Interceptor 中初始化與清理
public class UserContextFilter implements Filter {
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) {
        try {
            UserContext ctx = buildContext((HttpServletRequest) req);
            UserContextHolder.set(ctx);
            chain.doFilter(req, res);
        } finally {
            UserContextHolder.clear(); // 必須清理，防污染線程池
        }
    }
}

常見坑與避雷指南

總結

ThreadLocal 以「空間換時間」實現線程隔離，是框架級組件傳遞上下文的利器。業務代碼應封裝為 XxxContextHolder 統一管理生命週期，**切記用完即清**，配合線程池使用時更需嚴守清理契約。