InheritableThreadLocal 是 Java 中实现子线程继承父线程变量值的机制，通过重写 ThreadLocal 的 childValue 方法，在子线程构造时复制父线程值到 inheritableThreadLocals Map，之后父子线程变量完全独立；使用时仅需替换为 InheritableThreadLocal 类型，但线程池中因线程复用而不生效，需配合 TransmittableThreadLocal 或手动透传。

InheritableThreadLocal 是 Java 中用于实现子线程继承父线程变量值的机制，它通过重写 ThreadLocal 的两个关键方法，在线程创建时自动复制父线程的变量副本。

核心原理：线程创建时触发值继承

当新线程（子线程）被创建时，JVM 会在 Thread.init() 方法中检查父线程是否拥有 InheritableThreadLocal 实例。如果存在，就会调用其 childValue(T parentValue) 方法（默认返回父值本身），并将结果存入子线程的 inheritableThreadLocals Map 中。

这个过程只发生在子线程构造阶段，之后父子线程的变量完全独立，互不影响。

使用方式：直接替换 ThreadLocal 即可

只需把原本的 ThreadLocal 替换为 InheritableThreadLocal，其余用法一致：

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

• 定义：用 new InheritableThreadLocal() 替代 new ThreadLocal()
• 设置值：itl.set("hello") —— 父线程中调用
• 启动子线程后，在子线程中调用 itl.get() 即可拿到继承的值

注意继承时机与限制

继承只在子线程对象创建时发生，不是在线程 start() 时：

• 若父线程在子线程 new 之后、start() 之前修改了值，子线程仍继承的是 new 时刻的快照
• 线程池中的线程是复用的，不会触发继承逻辑；所以 InheritableThreadLocal 在线程池场景下通常失效
• 若需在线程池中传递上下文（如 TraceId），应配合 TransmittableThreadLocal（阿里 TTL 库）或手动透传

自定义 childValue 实现差异化继承

可重写 childValue 方法，让子线程获得加工后的值：

InheritableThreadLocal<list>> itl = new InheritableThreadLocal() {
    @Override
    protected List<string> childValue(List<string> parentValue) {
        if (parentValue == null) return new ArrayList();
        List<string> copy = new ArrayList(parentValue);
        copy.add("inherited-by-child"); // 添加标识
        return copy;
    }
};</string></string></string></list>

这样子线程拿到的就是带扩展信息的新副本，而非原始引用。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南