InheritableThreadLocal通过重写childValue()和createInheritedMap()，在子线程Thread.init()时浅拷贝父线程inheritableThreadLocals值，仅对new Thread()等直接创建的子线程生效，不适用于线程池复用场景。

InheritableThreadLocal 是 Java 中用于解决子线程继承父线程 ThreadLocal 变量的机制，它本身不是 ThreadLocal 的子类，而是通过扩展 Thread 类的内部字段（inheritableThreadLocals）来实现“可继承”的语义。

为什么普通 ThreadLocal 无法传递？

ThreadLocal 的变量存储在当前线程的 ThreadLocalMap 中，每个线程独有一份。子线程启动时会创建全新的 ThreadLocalMap，不会自动复制父线程的值 —— 所以默认情况下父子线程间无共享。

而 InheritableThreadLocal 在子线程构造时（即 Thread.init 阶段），会检查父线程是否存在非空的 inheritableThreadLocals，若存在则进行浅拷贝（仅 copy key-value 对，不 deep clone 值对象）。

基本用法：声明与赋值

使用方式和 ThreadLocal 几乎一致，只需把 new ThreadLocal() 换成 new InheritableThreadLocal()：

• 声明：private static final InheritableThreadLocal traceId = new InheritableThreadLocal();
• 设值：traceId.set("req-12345");
• 取值：String id = traceId.get();
• 清理（重要）：traceId.remove();，避免内存泄漏或上下文污染

注意继承时机与局限性

继承只发生在子线程创建那一刻，后续父线程修改 InheritableThreadLocal 的值，不会同步到已存在的子线程中。

典型误区示例：

• 父线程先启动子线程，再 set 值 → 子线程 get 到 null
• 子线程运行中，父线程修改值 → 子线程不受影响
• 线程池中的线程复用 → submit 的 Runnable 继承的是线程池线程“上次”可能残留的值，不可靠

因此，在线程池场景下，建议配合 TransmittableThreadLocal（阿里 TTL） 或手动透传（如包装 Runnable/Callable）来保障可靠性。

适合什么场景？

适用于简单、短生命周期、明确父子关系的线程模型，例如：

• Web 请求中主线程开启异步日志线程记录 traceId
• 单次任务分叉多个子任务，且不复用线程
• 测试中模拟嵌套线程调用链

不适合高并发、线程复用（如 Tomcat 线程池、自定义线程池）、跨线程通信要求强一致性的场景。