说起来，

在实际开发中。我们经常会遇到 ThreadLocal 取值为 null 的情况，排查起来往往无从下手。

一、三种主要原因

再看最常见原因，多个线程操作 ThreadLocal

这是开发中最易出现的情况。本质是对 ThreadLocal 的主要设计理念理解不到位——ThreadLocal 的变量副本是绑定到具体线程的，每个线程都有自己独立的副本，线程之间的副本相互隔离、互不影响。

原理解析： ThreadLocal 内部维护了一个 ThreadLocalMap。这个 Map 是线程的私有属性，而非 ThreadLocal 自身的属性。当我们调用 threadLocal.set 时是向当前线程的 ThreadLocalMap 中存入键值对；调用 threadLocal.get 时也是从当前线程的 ThreadLocalMap 中根据当前 ThreadLocal 对象取对应的值。按理说，

问题场景： 如果线程 A 调用 set 存入值。线程 B 调用 get 取值，由于线程 B 的 ThreadLocalMap 中没有线程 A 存入的键值对，自然会返回 null。这种问题常出现在多线程任务、线程池复用场景中。

再看代码示例，

public class ThreadLocalMultiThreadTest {
private static final ThreadLocal threadLocal = new ThreadLocal<>;怎么说呢，public static void main {
// 线程1：存入值
new Thread -> {
threadLocal.set;System.out.println);// 正常输出：线程1的变量副本
}).start;// 线程2：尝试取值
new Thread -> {
System.out.println);// 输出：null
}).start;}
}

易忽略原因的观点是，类加载器不同导致取不到值

这种原因相对隐蔽。很多开发者会忽略类加载器的影响，其本质是：不同类加载器加载同一个类，会生成两个不同的 Class 对象；而 ThreadLocal 作为变量的载体，若其所在的类被不同类加载器加载，会产生多个 ThreadLocal 实例。导致 set 和 get 操作的不是同一个 ThreadLocal 对象，最终取不到值。

原理解析： Java 中，一个类的唯一性由「类加载器 + 类全限定名」共同决定。假设我们有一个类 A，里面定义了 static ThreadLocal 变量。当类加载器1加载类 A 时会创建 ClassA1 和 ThreadLocal1；当类加载器2加载类 A 时会创建 ClassA2 和 ThreadLocal2。此时ThreadLocal1 和 Threaddbject# 话说回来，

问题场景： 常见于 Spring Boot DevTools 热部署 等场景。

import org.apache.commons.io.IOUtils;import java.io.ByteArrayOutputStream;import java.io.InputStream;import java.util.function.Supplier;public class StaticClassLoaderTest implements Supplier {
// 静态ThreadLocal变量
protected static final ThreadLocal local = new ThreadLocation;public StaticClassLoaderTest {}
// 存入值：向当前线程的ThreadLocaleMap中存入local和值
public void setInfo {
local.set;
System.out.println.getClassLoader);}
public static void main {
try {
// 使用程序类加载器加载当前类，创建实例并存入值
StaticClassLoaderTest supplier1 = new StaticClassLoaderTest;说起来，supplier1.setInfo;// 此时存入的是「AppClassLoader 加载的 local 实例」对应的数据
// 使用自定义类加载器 加载当前类。并尝试取值
Supplier staticClassLoaderTest2 =
Class.forName(
"gittest.StaticClassLoaderTest",true,new CusLoader)
.newInstance;System.out.println);// 输出：null
} catch {
e.printStackTrace;}
}
// 自定义类加载器：重写 loadClass 方法，优先读取指定方法中的字节码文件
public static class CusLoader extends ClassLoader {
@Override
protected Class loadClass
throws ClassNotFoundException {
if ) {
InputStream is = getContextClassLoader
.getResourceAsStream + ".class");ByteArrayOutputStream output = new ByteArrayOutputStream;try {
IOUtils.copy;怎么说呢，return defineClass(name。output.toByteArray,0,output.size);} catch { ex.printStackTrace;
}
}
return super.loadClass;
}
}
@Override
public Integer get {
System.out.println.getClassLoader);return Local.get;其实，}
}

再看原因。父子线程间取值

这种原因主要出现在父子线程场景中：父线程调用 ThreadLocale.set 存入后子进程 ThreadLocale.get,结果为 null。说到主要原因是，父子线条独立，各自拥有自己的 ThreadLocaleMap,子进程不会继承父进程中的数据.

说到痛点一，

• 你在异步任务或 Spring @Async 方法里调用 @Async,父请求已设置了安全上下文，但在异步方法里却打印null,让你抓狂.

• 你无法定位是在何处丢失了数据，因为所有日志都在主线下执行.

痛点二的观点是，

• 你只想保留业务层面的一份共享状态，却因为多余的数据泄露导致内存泄漏.

原理解析： - 父线条   有自己的 threadLocals Map . - 子线条启动时,它初始化自己的空 Map 而不是拷贝父线条的数据. - 所以即使父线条已 set 值,子线条 get 就找不到对应键,null.

问题场景: - 需要让子线条拿到请求级别上下文信息. - 常见于 Spring @Async 异步方法、CompletableFuture 或自定义 TaskExecutor 等异步框架.

至于代码示例。

html lang="">

body>
div id="">




'2026-08-03'

---

* 原始代码未完待补 *

---

---

---

示例代码整理

java // 简化版示例，仅展示关键逻辑

public interface AsyncService {

@Async // 异步执行，不在主请求线上下文中运行 void asyncGetContext;}

@Service public class AsyncServiceImpl implements AsyncService {

@Override public void asyncGetContext{

// 子线条无法看到父线条中的数据 String ctx = MyContextHolder.get;System.out.println;} }

如何解决？

方案一 : 使用 InheritableThreadLocale 替代 ThreadLocale. 适用于单纯创建新子线条时如 new Child。但如果你使用的是 Spring Boot 默认 TaskExecutor 或任何基于 Executor 的异步框架。则每个请求可能复用同一工作线条，该方案不保证数据完整性。

方案二 : 推荐使用 TransmittableThreadLocale . 它会自动拦截所有通过 Executor 提交任务。并把父级上下文复制到子级，从而兼容传统 Java 程序还有 Spring 框架中的异步组件。只需 现有
为 TTL 并添加依赖即可。下面给出最简实现方式:

xml "com.alibaba.ttl"" "ttl-core"" "1.0.9""

// 说到工具层，public final class ContextHolder{ private static final TransmittableThreadLocale` CONTEXT = new Transmittable... …，}

Tip: TTL 在 Spring MVC 环境下能自动捕获所有 request 层信息，不需要手工注解。

---

小结

场景	原因	检测方式	修复建议
多个任务在线程池上跑	同一 被多次 set/get	打印每次 set/get 时所属 ID 与 map size	用同步锁或局部变量替换 ,或确保每次 set 后 remove
DevTools 热部署或 OSGi 环境	同名 在不同 CL 下生成多实例	查看 CL 名称打印日志 .getcloader`)	强制统一 CL 或使用全局单例管理
@Async / CompletableFuture / ExecutorJobPool	父子 不共享上下文	在 async 方法内打印 MyContextHolder.get 与主流行日志比较	用 Inheritable/TTL 包装；或显式传递参数

以上三种情形均可归结为 “set 与 get 的对象/环境不匹配”。只要记住这点，你就能快速定位并消除大多数不可预料 NullPointerError。

---

---