目录ThreadLocal一、场景引入二、核心底层原理基础结构说明set () /get () 完整执行流程线程隔离本质三、代码示例四、重要注意事项五、生活化类比ThreadLocal一、场景引入Tomcat 依靠线程池处理客户端请求每一个用户请求都会分配线程池中的一条工作线程执行请求处理完成后线程回收复用。由于每条请求由独立线程执行我们可以借助 ThreadLocal 实现线程数据隔离让每条线程只操作属于自身的数据常用来存储登录用户信息、请求上下文、链路追踪 ID 等数据。二、核心底层原理基础结构说明每个 Thread 线程对象内部自带专属容器 ThreadLocalMap该容器归当前线程独有多个不同的 ThreadLocal 实例可以共用当前线程这一张 ThreadLocalMap 完成数据存取。区分ThreadLocal 只是提供存取数据的操作工具并不是存储数据的容器真正存储数据的载体是线程内部的 ThreadLocalMap。set () /get () 完整执行流程set (value)获取当前执行线程 → 获取该线程独有的 ThreadLocalMap → 以当前 ThreadLocal 实例作为 key存入 value。get ()获取当前执行线程 → 获取线程的 ThreadLocalMap → 使用 ThreadLocal 实例作为 key 查询对应数据。线程隔离本质多个线程共用同一个全局 ThreadLocal 静态对象操作数据时数据分别保存在各自线程内部的 ThreadLocalMap 中天然互不干扰以此实现线程隔离。 常见误区澄清重点补充静态的 ThreadLocal 实例是全局唯一所有线程共享同一个 ThreadLocal 对象。很多人会产生疑问多个线程共用同一个 keyCPU 时间片切换交替执行会不会出现数据相互覆盖原理解答传统认知中「同一个 Map 内 key 重复会覆盖 value」这条规则依旧成立但是每条线程拥有独立的 ThreadLocalMap。共用的 ThreadLocal 只是 key 对象但是存取操作发生在不同线程相互隔离的 Map 容器中跨 Map 不存在 key 冲突、数据覆盖问题。通俗理解相当于同一把钥匙去不同房间各自独立的储物柜存放物品互不干扰。补充设计思考不推荐每个线程单独 new ThreadLocal如果每个线程创建独立 ThreadLocal 实例不同的 key就失去了统一的数据访问入口违背 ThreadLocal 设计目标。三、代码示例public class ThreadLocalDemo { // 定义全局静态ThreadLocal对象多个线程共用这同一个对象 private static final ThreadLocalString contextTl new ThreadLocal(); public static void main(String[] args) { // 线程1 new Thread(() - { contextTl.set(用户A的上下文信息); System.out.println(Thread.currentThread().getName() contextTl.get()); // 使用完毕清除数据 contextTl.remove(); }, 线程1).start(); // 线程2 new Thread(() - { contextTl.set(用户B的上下文信息); System.out.println(Thread.currentThread().getName() contextTl.get()); contextTl.remove(); }, 线程2).start(); } }运行结果线程1用户A的上下文信息 线程2用户B的上下文信息说明两个线程使用同一个 contextTl 对象调用 set、get读取到各自独立的数据互不影响。即便操作系统切换线程时间片交替执行也不会发生数据覆盖。四、重要注意事项注意 1在线程池场景Tomcat 工作线程池、自定义线程池线程会被重复复用。任务 / 请求处理完成后必须调用 threadLocal.remove () 清理数据避免下一个复用该线程的任务读取遗留脏数据。⚠️区分并发执行多条独立线程不会互相覆盖数据脏数据问题来源于线程复用不是并发调度冲突。注意 2ThreadLocalMap 的 key 设计为弱引用目的尽可能缓解内存泄漏风险但 value 依旧存在强引用关系弱引用无法完全杜绝内存泄漏不能替代手动执行 remove 操作。注意 3同一个线程中可以声明多个 ThreadLocal 实例所有数据都会存放在该线程唯一的 ThreadLocalMap 中依靠不同 ThreadLocal 实例作为 key 区分数据。注意 4隐藏陷阱如果向 ThreadLocal 存放可变共享对象。虽然 ThreadLocal 隔离性生效各线程 Map 保存独立引用但是多个引用指向堆中同一个对象任意线程修改对象内部属性其他线程会受到影响。这不属于 ThreadLocal 失效是共享可变对象引发的并发问题。注意5是否需要为每个线程新建独立 ThreadLocal以使用key的弱引用回收不需要也不推荐。ThreadLocal 的设计目标就是全局共用同一个实例作为访问入口依靠每条线程独立的 ThreadLocalMap 实现隔离。两种使用形式对比static final 全局 ThreadLocal项目标准用法存储请求上下文、登录信息 静态变量长期持有强引用Entry 内弱引用 key 无法被 GC 回收JVM 自动清理机制失效任务结束必须手动 remove ()不能指望 GC 自动释放。方法内局部 ThreadLocal极少业务场景方法运行结束后强引用消失GC 可以回收 ThreadLocal 对象触发 Map 自动清理过期 Entry但清理时机完全不可控依然不建议依赖该机制。总结弱引用只是兜底防护手段不能替代 remove () 操作。无论哪种写法在线程池场景请求处理完成都要手动清理。五、生活化类比每条线程 一间独立办公室自带储物柜ThreadLocalMapThreadLocal 一把专属钥匙set拿着钥匙在当前办公室储物柜存放物品get拿着钥匙在当前办公室储物柜取出物品同一把钥匙去到不同办公室操作的都是每个办公室自己的储物柜互不影响。
)
