🚀 為什么要用 TransmittableThreadLocal？一文讀懂線程上下文傳遞問題

在 Java Web 開發中，我們經常用 ThreadLocal 來保存每個請求的用戶信息，例如 userId。但當我們使用線程池或異步方法（如 @Async）時，很多人會遇到這樣的問題：

? 主線程設置了 ThreadLocal，子線程里卻拿不到！

這是因為 ThreadLocal 的值默認不會在線程池中傳遞到子線程，會導致上下文丟失，比如 userId 為 null，traceId 無法傳遞等問題。

---

🧩 問題重現

// 主線程中設置用戶 ID
UserContext.setUserId(123L);// 子線程中獲取（比如線程池執行）
executorService.submit(() -> {System.out.println(UserContext.getUserId()); // 輸出 null
});

? 解決方案：使用阿里開源的 TransmittableThreadLocal (TTL)

TransmittableThreadLocal 是阿里巴巴開源的增強版 ThreadLocal，可以將主線程中的上下文信息，傳遞到子線程中（包括線程池中）。

簡單改造：

1. 引入依賴

<dependency><groupId>com.alibaba</groupId><artifactId>transmittable-thread-local</artifactId><version>2.14.2</version> <!-- 版本可選最新 -->
</dependency>

2. 替換原有 ThreadLocal

public class UserContext {private static final TransmittableThreadLocal<Long> userIdThreadLocal = new TransmittableThreadLocal<>();public static void setUserId(Long userId) {userIdThreadLocal.set(userId);}public static Long getUserId() {return userIdThreadLocal.get();}public static void clear() {userIdThreadLocal.remove();}
}

3. 包裝子線程任務

Runnable task = () -> {System.out.println(UserContext.getUserId());
};executorService.submit(TtlRunnable.get(task)); // TTL 包裝，自動傳遞上下文

---

? Spring 用戶更方便

如果你使用 Spring 的 @Async 或線程池，可以配合 TTL 的 插件支持 實現自動上下文傳遞，無需手動包裝。

---

📌 總結對比

對比項	ThreadLocal	TransmittableThreadLocal
支持線程上下文傳遞	? 否	? 是
在線程池中能獲取值	? 否	? 是
推薦場景	單線程	多線程、異步、線程池
是否侵入業務代碼	? 少	? 極小，可自動適配

---

🧠 使用 TTL，你可以輕松實現：

• 日志 traceId 傳遞
• 用戶上下文（userId、token）傳遞
• 請求頭信息傳播
• 分布式鏈路追蹤

---

🔗 推薦閱讀項目地址：https://github.com/alibaba/transmittable-thread-local

歡迎點贊、評論交流你在實際使用中的坑與經驗 👇