news 2026/4/16 13:30:52

一文看懂ThreadLocal的原理

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
一文看懂ThreadLocal的原理

先看下ThreadLocal的基本用法,创建5个线程给同一个ThreadLocal变量设置不同的值,从打印结果看每个线程设置和获取的值都是不同的,可见ThreadLocal为线程安全的,每个线程保存的值相互独立。

public class ThreadLocalTest { public static ThreadLocal local = new ThreadLocal(); public static void main(String[] args) { for (int i = 0; i < 5; i++){ new Thread(new Runnable() { @Override public void run() { local.set("hello" + Thread.currentThread()); System.out.println(local.get()); } }).start(); } } } //打印结果为: helloThread[Thread-4,5,main] helloThread[Thread-3,5,main] helloThread[Thread-2,5,main] helloThread[Thread-0,5,main] helloThread[Thread-1,5,main]

现在开始ThreadLocal的原理,过程比较复杂。首先看下ThreadLocal的set()方法存数据的过程,获取调用set方法的线程中持有的ThreadLocalMap(ThreadLocal.ThreadLocalMap threadLocals = null;),每个线程的ThreadLocalMap都是独立的,因此存储的值是不同的。

public void set(T value) { Thread t = Thread.currentThread(); ThreadLocalMap map = getMap(t); if (map != null) { map.set(this, value); } else { createMap(t, value); } } // 获取线程内置的ThreadLocalMap ThreadLocalMap getMap(Thread t) { return t.threadLocals; }

如果在一个线程中首次使用ThreadLocal保持数据,则需要创建ThreadLocalMap,ThreadLocalMap中保存数据的实体是Entry,保存数据的过程就是先计算这个ThreadLocal对象的hashcode,根据hashcode计算在Entry数组中的位置,然后将创建的Entry保存在这个位置。

void createMap(Thread t, T firstValue) { t.threadLocals = new ThreadLocalMap(this, firstValue); } ThreadLocalMap(ThreadLocal<?> firstKey, Object firstValue) { table = new Entry[INITIAL_CAPACITY]; int i = firstKey.threadLocalHashCode & (INITIAL_CAPACITY - 1); table[i] = new Entry(firstKey, firstValue); size = 1; setThreshold(INITIAL_CAPACITY); } // 弱引用 static class Entry extends WeakReference<ThreadLocal<?>> { /** The value associated with this ThreadLocal. */ Object value; Entry(ThreadLocal<?> k, Object v) { super(k); value = v; } }

调用set()设置值的时候,会根据ThreadLocal计算hashcode。ThreadLocal中的属性threadLocalHashCodeprivate final int threadLocalHashCode = nextHashCode();用来维护每个ThreadLocal的hash值。再根据hashcode计算Entry数组的索引,根据索引找到当前线程对应的Entry,这里分三种情况:

  1. 第一次设值,则直接添加如果是当前线程使用的ThreadLocalif (k == key),则将对象设置进来,即写到存储数据的Entry中
  2. ThreadLocalif (k == key)已经有值了,就直接更新
  3. ThreadLocal作为临时变量被gc了if (k == null),例如在方法代码块中声明的ThreadLocal临时变量在方法执行完时不存在了,Entry中的ThreadLocal作为key是弱引用就会被gc;或者线程销毁了,此时指向Entry的引用不存在了,Entry也会被gc,此时如果不gc的话就会出现一块无法访问到的Entry,造成内存泄漏。

set()时如果发现hash冲突,ThreadLocal的做法是向后移动一位,到数组的下个索引处保存Entry,如果下个索引处有值了再继续向后找。

private void set(ThreadLocal<?> key, Object value) { Entry[] tab = table; int len = tab.length; int i = key.threadLocalHashCode & (len-1); for (Entry e = tab[i]; e != null; e = tab[i = nextIndex(i, len)]) { ThreadLocal<?> k = e.get(); // 更新 if (k == key) { e.value = value; return; } // 临时ThreadLocal被回收的处理 if (k == null) { replaceStaleEntry(key, value, i); return; } } // 第一次直接设置 tab[i] = new Entry(key, value); int sz = ++size; if (!cleanSomeSlots(i, sz) && sz >= threshold) rehash(); } // 向后移动一位 private static int nextIndex(int i, int len) { return ((i + 1 < len) ? i + 1 : 0); }

当通过get()方法获取数据时,首先找到当前的线程对象,获取线程对象内部的ThreadLocalMap,然后根据ThreadLocal对象计算Entry的索引,找到本线程存储数据的Entry,获取Entry中的数据。

public T get() { Thread t = Thread.currentThread(); ThreadLocalMap map = getMap(t); if (map != null) { ThreadLocalMap.Entry e = map.getEntry(this); if (e != null) { @SuppressWarnings("unchecked") T result = (T)e.value; return result; } } return setInitialValue(); } private Entry getEntry(ThreadLocal<?> key) { int i = key.threadLocalHashCode & (table.length - 1); Entry e = table[i]; if (e != null && e.get() == key) return e; else return getEntryAfterMiss(key, i, e); }
  • ThreadLocal内存泄漏的问题
    可以看到Entry是指向ThreadLocal的弱引用,弱引用不会阻止gc的垃圾回收,如果这个ThreadLocal对象置为null,指向ThreadLocal对象的弱引用不会阻止gc的垃圾回收,此时ThreadLocal对象会被gc回收,通过get()方法获取value时需要计算ThreadLocal对象的hashcode,在ThreadLocal对象被回收的情况就无法计算hashcode,也就无法访问这个value引用的对象,于是value就成了有引用链但是无法被访问的内存,即造成内存泄漏了。
static class Entry extends WeakReference<ThreadLocal<?>> { /** The value associated with this ThreadLocal. */ Object value; Entry(ThreadLocal<?> k, Object v) { super(k); value = v; } }

解决方法:

  1. 将ThreadLocal变量定义成private static,这样就一直存在ThreadLocal的强引用,可以通过ThreadLocal对象访问到保存的数据,不会造成内存泄漏
  2. 调用remove()方法清除内存
public void remove() { ThreadLocalMap m = getMap(Thread.currentThread()); if (m != null) { m.remove(this); } } private void remove(ThreadLocal<?> key) { Entry[] tab = table; int len = tab.length; int i = key.threadLocalHashCode & (len-1); for (Entry e = tab[i]; e != null; e = tab[i = nextIndex(i, len)]) { if (e.get() == key) { e.clear(); expungeStaleEntry(i); return; } } }

总结一下,每个ThreadLocal都有每个线程对应的ThreadLocalMap用于保存数据,每个线程的ThreadLocalMap对象都不相同,所以是线程安全的。ThreadLocal存在内存泄漏问题,需要持有ThreadLocal的强引用或remove清理。有不对的地方请大神指出,欢迎大家一起讨论交流,共同进步,更多请关注微信公众号 葡萄开源。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/15 16:03:42

Java实现无人健身房物联网系统解析

以下从技术架构深度解析、核心模块实现逻辑、安全与性能优化实践三个维度&#xff0c;对基于Java的无人共享健身房物联网系统进行系统性拆解&#xff1a;一、技术架构深度解析&#xff1a;分层设计与微服务协同表现层多端适配机制UniApp框架&#xff1a;通过Vue语法实现“一次开…

作者头像 李华
网站建设 2026/4/16 7:47:12

强烈安利10个AI论文工具,专科生搞定毕业论文不求人!

强烈安利10个AI论文工具&#xff0c;专科生搞定毕业论文不求人&#xff01; AI工具&#xff0c;让论文写作不再难 对于专科生来说&#xff0c;毕业论文的撰写往往是一道难以跨越的难关。面对繁重的写作任务、复杂的格式要求以及对学术规范的不熟悉&#xff0c;很多学生感到无从…

作者头像 李华
网站建设 2026/4/16 4:53:55

汽车制造行业KindEditor如何处理设计图WORD粘贴?

企业网站Word粘贴和导入功能开发全记录 需求分析与技术评估 作为福建某软件公司的前端工程师&#xff0c;我最近接到一个企业网站后台管理系统的功能升级需求。客户希望在现有的KindEditor编辑器中增加Word粘贴和文档导入功能&#xff0c;同时支持微信公众号内容粘贴并自动处…

作者头像 李华
网站建设 2026/4/16 12:52:01

免费Nano Banana 制作PPT,SpeedAI 智能体一句话生成

大家好&#xff0c;这里是K姐。 一个帮你追踪最新AI应用的女子&#xff01; 2026了&#xff0c;不会还有打工人述职汇报是自己哼哧哼哧手搓 PPT 吧&#xff1f; 想用 AI 做 PPT 省时间&#xff0c;很多人第一反应就是 Nano Banana。确实不少大佬用做 Nano Banana 的 PPT&…

作者头像 李华
网站建设 2026/4/16 9:22:00

Flutter 三端应用实战:OpenHarmony 简易文本首字母提取器开发指南

一、为什么需要“简易文本首字母提取器”&#xff1f; 在 OpenHarmony 的内容摘要、笔记整理与快速索引场景中&#xff0c;“首字符”具有独特的信息密度价值&#xff1a; 学生&#xff1a;从课堂笔记中快速提取关键词首字&#xff0c;构建记忆锚点&#xff1b;程序员&#x…

作者头像 李华