ThreadLocal为每个线程提供独立变量副本，避免共享变量并发问题；需用static final声明、withInitial()初始化、及时remove防内存泄漏，适用于用户上下文、SimpleDateFormat等线程绑定场景。
ThreadLocal 是 Java 中实现线程局部变量的核心工具，它让每个线程拥有自己独立的变量副本，天然避免共享数据带来的并发问题。关键不在于“怎么存”，而在于“谁来清理”和“何时初始化”。
ThreadLocal 的基本用法
声明一个 ThreadLocal 变量时，通常使用 static final 修饰，确保全局唯一实例；每个线程调用 get() 时自动初始化（如果未 set 过），调用 set() 可覆盖当前线程的值。
- 初始化推荐用 withInitial() 方法，比重写 initialValue() 更简洁安全
- 不要依赖构造函数传参初始化，ThreadLocal 本身不接受参数
- 示例：private static final ThreadLocal
DATE_FORMAT = ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd"));
注意内存泄漏风险
ThreadLocal 的底层是把数据存在当前线程的 ThreadLocalMap 中，key 是弱引用（WeakReference），value 是强引用。如果线程长期运行（如线程池中的线程），而 ThreadLocal 实例被回收了，但 value 还在 map 里，就会造成内存泄漏。
- 每次用完务必调用 remove()，尤其在线程复用场景（如 Web 容器、线程池）中
- 避免将大对象（如 List、Map、Connection）直接塞进 ThreadLocal
- 若必须存储复杂对象，建议封装为轻量级 holder 类，并在 remove 前手动释放资源
典型适用场景
不是所有“需要线程隔离”的地方都适合 ThreadLocal，它更适合生命周期与线程绑定、且无需跨线程传递的数据。
立即学习“Java免费学习笔记（深入）”；
- 用户上下文（如登录信息、请求 traceId），在 Filter/Interceptor 中 set，在 Service 层 get
- 数据库连接或事务状态（某些老框架中用于手动管理事务）
- 格式化工具类（如 SimpleDateFormat、DateTimeFormatter）——避免同步开销
- 不适用于异步调用（如 CompletableFuture、@Async），子线程无法自动继承父线程的 ThreadLocal 值
跨线程传递的小技巧
如果确实需要把父线程的 ThreadLocal 值传给子线程（比如 ForkJoinPool 或自定义线程池），需手动处理：
- 继承 ThreadPoolExecutor，重写 beforeExecute() 和 afterExecute() 来复制/清理
- 使用 InheritableThreadLocal 替代普通 ThreadLocal（仅对直接创建的子线程有效，对线程池无效）
- 更可靠的方式：显式把上下文作为参数传入任务，例如 new Task(context) 或使用 CompletableFuture.supplyAsync(() -> ..., executor) 配合闭包捕获
