threadlocal 为每个线程提供独立变量副本，避免同步问题；其值存于各线程的 threadlocalmap 中，需遵循初始化、set/get、remove 三步法，尤其在线程池中必须及时清理以防内存泄漏和脏数据。
ThreadLocal 是 Java 中实现线程级数据隔离的核心工具，它为每个线程提供独立的变量副本，避免共享数据带来的同步问题。关键在于理解它不是“线程安全的容器”，而是“让每个线程拥有自己的变量实例”。
ThreadLocal 的本质：每个线程持有一份独立副本
ThreadLocal 并不存储值本身，而是作为 key，配合当前线程的 Thread 对象内部的 ThreadLocalMap 使用。每个 Thread 实例都持有一个 ThreadLocalMap（弱引用 key），真正存放数据的是这个 map 中以 ThreadLocal 为 key、用户值为 value 的条目。
- 不同线程调用同一个 ThreadLocal 实例的 get()，拿到的是各自 map 中对应的不同值
- 主线程设置的值，子线程默认拿不到（除非显式继承，见下文）
- 值的生命周期与线程绑定，线程结束时若未手动 remove，可能引发内存泄漏（尤其在线程池中）
典型使用模式：初始化 + set/get + 及时清理
正确使用 ThreadLocal 需遵循“三步法”，尤其在使用线程池时不可省略清理步骤：
-
初始化：通过
new ThreadLocal()创建；推荐用withInitial()设置默认值，避免首次 get 返回 null -
写入：在业务逻辑入口（如 Web Filter、RPC 拦截器）调用
tl.set(value) -
读取：在需要上下文的地方调用
tl.get() -
清理：务必在 finally 块或 try-with-resources 中调用
tl.remove()，防止线程复用导致脏数据或内存泄漏
示例：
// ... 在请求处理开始
CONTEXT.set(parseUserContext(request));
try {
// 业务逻辑中随时 get()
UserContext ctx = CONTEXT.get();
} finally {
CONTEXT.remove(); // 关键！
}
父子线程传递：InheritableThreadLocal 的适用与限制
普通 ThreadLocal 的值不会自动传递给子线程。如需继承（例如异步任务需访问父线程上下文），可改用 InheritableThreadLocal：
- 子线程创建时会复制父线程 ThreadLocalMap 中所有 InheritableThreadLocal 的值
- 仅限直接创建的子线程（new Thread()），对线程池中的线程无效（因为线程被复用，不是新创建）
- 值是“快照式”复制，后续父线程修改不影响子线程，子线程修改也不影响父线程
注意：Spring 的 RequestContextHolder 等机制底层就依赖 InheritableThreadLocal，并配合框架生命周期做清理。
常见陷阱与规避建议
ThreadLocal 虽简单，但误用后果严重：
- 线程池场景不 remove → 上一个任务留下的值污染下一个任务 → 必须在 finally 或统一拦截点清理
- 静态 ThreadLocal + 泛型擦除 → 多个类共用同一静态实例易混用 → 每个上下文类型声明独立的 static final ThreadLocal
- Web 应用中忘记清理 → 请求结束后 context 仍驻留线程 → 结合 Filter 或 Spring Interceptor 统一管理生命周期
- 误以为 ThreadLocal 是“全局线程安全” → 它解决的是“无共享”，而非“并发安全”；若值对象本身可变且被多处修改，仍需同步
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
