在 Spring Boot 或普通 Java 应用中，使用 ThreadLocal 来保存线程级变量时，有一个常见问题：子线程无法继承父线程的 ThreadLocal 值，因为普通 ThreadLocal 是线程隔离的。下面我帮你整理几种实现 父子线程传值的方式，包括 Spring 环境常用方法。

Spring Boot 中 ThreadLocal 父子线程传值的几种方式

一、使用 InheritableThreadLocal

1. 原理

  • InheritableThreadLocal 是 ThreadLocal 的子类
  • 父线程创建子线程时，子线程会自动拷贝父线程的值

2. 示例代码

public class ThreadLocalExample {

    private static InheritableThreadLocal<String> context = new InheritableThreadLocal<>();

    public static void main(String[] args) {
        context.set("父线程数据");

        Thread childThread = new Thread(() -> {
            System.out.println("子线程获取值: " + context.get());
        });

        childThread.start();
    }
}

输出：

子线程获取值: 父线程数据

3. 注意事项

  • 如果线程池复用线程（如 @Async 或 ThreadPoolTaskExecutor），InheritableThreadLocal 会失效，因为线程不是新建的
  • 不适用于线程池场景

二、使用 TransmittableThreadLocal（TTL）

1. 原理

  • 阿里开源
  • 解决 父子线程传值 + 线程池复用线程 问题
  • 自动把父线程值传递给子线程

2. Maven 依赖

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>transmittable-thread-local</artifactId>
    <version>2.13.0</version>
</dependency>

3. 示例代码

TransmittableThreadLocal<String> ttl = new TransmittableThreadLocal<>();
ttl.set("父线程数据");

// 包装线程池
ExecutorService executor = TtlExecutors.getTtlExecutorService(Executors.newFixedThreadPool(2));

executor.submit(() -> {
    System.out.println("子线程获取值: " + ttl.get());
});

输出：

子线程获取值: 父线程数据

4. 特点

  • 支持线程池场景
  • 自动传播父线程 ThreadLocal 值
  • TTL + Spring @Async 配合可直接使用

三、手动传递 ThreadLocal 值

1. 原理

  • 父线程先获取 ThreadLocal 值
  • 创建子线程时，将值传递给子线程

2. 示例代码

ThreadLocal<String> threadLocal = new ThreadLocal<>();
threadLocal.set("父线程数据");

String parentValue = threadLocal.get();

Thread childThread = new Thread(() -> {
    threadLocal.set(parentValue);
    System.out.println("子线程获取值: " + threadLocal.get());
});

childThread.start();

3. 特点

  • 简单可控
  • 适合少量子线程传值
  • 如果线程池复用线程，需要在提交任务时手动清理 ThreadLocal

四、Spring Boot 环境的额外注意

  1. 使用 @Async 时
    • 默认线程池复用线程，普通 ThreadLocal 无法自动传值
    • 可以使用 TransmittableThreadLocal + TtlExecutors 或者自己包装 Executor
  2. RestTemplate + 异步调用
    • 若需要传递用户上下文或请求 ID（如日志追踪 X-Request-ID）
    • 建议使用 TTL 或手动传递上下文
  3. ThreadLocal 清理
    • 使用完必须 remove()，避免内存泄漏
    • 尤其在使用线程池的情况下

总结

方式是否支持线程池使用难度备注
InheritableThreadLocal❌ 不支持线程池复用简单适合新建线程传值
TransmittableThreadLocal✅ 支持线程池中等推荐 Spring Boot 异步场景
手动传递✅ 支持简单可控，但需手动清理 ThreadLocal