InheritableThreadLocal 是 Java 中用于父子线程间自动传递变量的机制，子线程创建时复制父线程中该变量的快照值，仅在 Thread.init() 阶段触发一次继承，线程池复用场景不适用，需手动透传或使用 TransmittableThreadLocal。
InheritableThreadLocal 是 Java 中用于在父子线程间自动传递变量的机制，它继承自 ThreadLocal，但关键区别在于：当子线程被创建时，会**自动复制父线程中 InheritableThreadLocal 的值**（调用时的快照），从而实现变量的“继承”。
核心原理：创建子线程时触发 copy
Java 在 Thread.init() 方法中，判断当前线程（父线程）是否有非空的 inheritableThreadLocals（即父线程使用过 InheritableThreadLocal），如果有，就调用其 childValue() 方法，将值拷贝给子线程。这个过程只发生在子线程构造阶段，后续父线程修改值，不会影响已存在的子线程。
基本用法示例
以下代码演示了如何让子线程访问父线程设置的上下文 ID：
InheritableThreadLocal<String> traceId = new InheritableThreadLocal<>();
// 父线程设置
traceId.set("req-12345");
new Thread(() -> {
// 子线程可直接 get()，得到 "req-12345"
System.out.println(traceId.get()); // 输出：req-12345
}).start();
注意继承时机与常见陷阱
- 只在 子线程对象构造时 复制一次，之后父线程修改不影响子线程
- 线程池中的线程是复用的，不是新创建的，因此 不会触发继承 —— 这是最常见的误用点
- 若需在线程池中传递，必须手动透传（如借助
TransmittableThreadLocal或包装Runnable） -
childValue(T parentValue)可被重写，用于定制子线程获取的值（例如深拷贝、加前缀等）
适合什么场景？
- 短生命周期的临时线程（如
new Thread(...).start()） - 日志链路追踪 ID 的初始传播（父线程生成 ID，子线程沿用）
- 测试中模拟简单上下文透传，不涉及线程复用
