ThreadLocalMap 和 HashMap 的区别？

简单来说，ThreadLocalMap 是 ThreadLocal 的内部类，专门为线程本地变量设计的哈希表；而 HashMap 是一个通用的、可以在多线程间共享的键值对集合。它们在设计目标、数据结构、键的引用类型、以及对 null 的处理上都有显著差异。

深度解析

下面我们深入拆解一下两者的具体区别。

HashMap：属于 Java 集合框架（java.util 包），是一个通用的、功能完备的 Map 实现。它的设计目标是满足各种日常的键值存储需求。
ThreadLocalMap：属于 Java 并发库（java.lang 包下 ThreadLocal 类的内部类），是一个高度定制化的 Map。它的设计目标只有一个：为每个线程关联自己的变量副本。它不实现 Map 接口，对外部也完全不可见，只能通过 ThreadLocal 的 get()、set() 方法来间接操作。

这是两者最核心的技术差异。

HashMap：采用数组 + 链表 + 红黑树的数据结构。当多个键哈希到同一个桶（bucket）时，使用链地址法（拉链法）解决冲突。如果链表长度超过阈值（默认为 8），会树化成红黑树以提高查询效率。
ThreadLocalMap：内部只维护了一个简单的 Entry 数组。当发生哈希冲突时，它并没有使用链表，而是采用了开放地址法的线性探测来解决。也就是说，如果计算出的索引位置已经被占用了，它会继续往后寻找下一个空闲的索引。
为什么 ThreadLocalMap 用开放地址法？

主要原因有两点：
1. 存储数据量小：ThreadLocalMap 是为每个线程设计的，一个线程中定义的 ThreadLocal 变量数量通常很少，不会像全局 HashMap 那样存储成千上万的数据。冲突的概率相对较低，线性探测的开销可以接受。
2. 避免使用大量链表节点：HashMap 的链表/红黑树节点会额外占用内存。ThreadLocalMap 的设计目标是轻量、高效，开放地址法在数据量小时内存占用更紧凑，查询效率也很高。

HashMap：对 key 和 value 都是强引用 (Strong Reference)。只要 HashMap 对象本身不被回收，里面的键值对就不会被垃圾回收。
ThreadLocalMap：它的 Entry 继承了 WeakReference<ThreadLocal>，key （也就是 ThreadLocal 对象）被包装成了一个弱引用 (Weak Reference)，但 value 仍然是强引用。
```
// ThreadLocalMap 中的 Entry 源码（JDK 8+）
static class Entry extends WeakReference<ThreadLocal<?>> {
    /** The value associated with this ThreadLocal. */
    Object value;

    Entry(ThreadLocal<?> k, Object v) {
        super(k);
        value = v;
    }
}
```
这里就是内存泄漏风险的关键点：

当我们在代码中将 ThreadLocal 对象设置为 null（比如 threadLocal = null）后，由于 Entry 的 key 是弱引用，在下一次 GC 时，这个 ThreadLocal 对象就会被回收。但是，Entry 中的 value 是强引用，如果这个线程一直存活（比如线程池中的核心线程），那么 value 就会一直存在一条引用链： Thread （当前线程） -> ThreadLocalMap -> Entry -> value 导致 value 永远无法被回收，从而造成内存泄漏。

最佳实践：每次使用完 ThreadLocal 后，尤其是在线程池环境下，一定要显式调用 remove() 方法，清除整个 Entry，避免内存泄漏。

HashMap：允许 key 和 value 都为 null。HashMap 专门把 key 为 null 的 Entry 放在 table[0] 这个桶里。
ThreadLocalMap：key （即 ThreadLocal 对象）不允许为 null。因为它的 key 本身就是通过 ThreadLocal 对象来计算的。如果 ThreadLocal 为 null，就无法定位到对应的 Entry 了。不过它的 value 是可以为 null 的，ThreadLocal 的 initialValue() 方法默认就返回 null。

HashMap：是 public 类，我们可以直接 new HashMap<>()，然后调用 put()，get() 等方法。
ThreadLocalMap：是包私有（default）的，我们无法直接创建它的实例。它完全作为 ThreadLocal 的服务类存在。我们通过 ThreadLocal 的 set() 和 get() 方法来间接操作当前线程的 ThreadLocalMap。

posted @ 2026-03-20 15:12 网络大法师阅读(14) 评论(0) 收藏举报

刷新页面返回顶部