如何利用 ThreadLocal 在线程内实现变量的私有隔离-java教程-PHP中文网

threadlocal不是线程私有变量的自动托管工具，而是以线程为维度的map查找机制；真正隔离靠每个线程独立持有threadlocalmap实例，static final声明仅共享threadlocal对象本身，各线程操作的是各自thread.threadlocals中的值。

如何利用 threadlocal 在线程内实现变量的私有隔离

ThreadLocal 不是“线程私有变量”的自动托管工具，它只是提供了一种以线程为维度的 Map 查找机制；真正隔离靠的是每个线程持有独立的 ThreadLocalMap 实例。

为什么直接 new ThreadLocal() 不能保证线程安全？

很多人误以为声明一个 static final ThreadLocal<string> holder = new ThreadLocal();</string> 就万事大吉——其实这只是共享了同一个 ThreadLocal 实例，而每个线程访问时，底层会从自己的 Thread.threadLocals（即 ThreadLocalMap）中 get/set 值。关键点在于：

ThreadLocal.set() 写入的是当前线程对象内部的 threadLocals 字段，与其他线程完全无关
如果忘记调用 remove()，在线程复用场景（如线程池）下会导致内存泄漏：key 是弱引用，value 是强引用，GC 清不掉 value
子线程不会自动继承父线程的 ThreadLocal 值，除非显式使用 InheritableThreadLocal

在线程池中使用 ThreadLocal 的正确姿势

线程池里线程被反复使用，ThreadLocal 的 value 若未清理，上一次请求留下的值可能污染下一次请求。典型错误是只在业务逻辑开头 set()，却没在结尾 remove()。

务必在 try-finally 中调用 remove()，例如：

try {
    contextHolder.set(userContext);
    doWork();
} finally {
    contextHolder.remove(); // 必须！不能只用 set(null)
}

不要用 set(null) 代替 remove()：这只会把 value 设为 null，entry 仍存在，key 为 null 的 stale entry 积累后会触发 ThreadLocalMap 的探测式清理，但不可靠
若需初始化默认值，优先重写 initialValue() 方法，而非在业务代码里判断 null 后 set —— 更简洁且天然线程安全

ThreadLocal 与 InheritableThreadLocal 的行为差异

普通 ThreadLocal 对子线程完全不可见；InheritableThreadLocal 则在子线程创建时，把父线程对应 key 的 value 复制一份（浅拷贝）到子线程的 ThreadLocalMap 中。

仅对 new Thread() 有效；ExecutorService 提交的 Runnable 不触发继承（因为不是新线程，而是复用）
复制发生在 Thread.init() 阶段，之后父线程修改不影响子线程，子线程修改也不影响父线程
若需跨异步任务传递上下文（如 WebFlux、CompletableFuture），得配合 TransmittableThreadLocal（阿里 TTL 库）或手动透传