InheritableThreadLocal 是 Java 中实现父子线程间自动传递 ThreadLocal 值的机制，值仅在子线程创建时复制父线程当前值，后续修改互不影响；线程池中因线程复用需手动清理或改用 TransmittableThreadLocal。
InheritableThreadLocal 是 Java 中用于在父子线程间自动传递线程局部变量的机制。它继承自 ThreadLocal，核心区别在于：当子线程被创建时，会**自动复制父线程中 InheritableThreadLocal 的值**（调用时点是子线程构造阶段），后续修改互不影响。
值传递发生在子线程创建时，不是运行时
关键要理解：传递只在 new Thread() 或线程池中首次执行任务时发生，且仅拷贝「那一刻」父线程中该 InheritableThreadLocal 的值。之后父线程修改、子线程修改，彼此完全隔离。
- 主线程设置
itl.set("A")→ 启动子线程 → 子线程初始值为 "A" - 主线程随后改
itl.set("B")→ 不影响子线程已有的值 - 子线程调用
itl.set("C")→ 不影响主线程的 "B"
线程池中需特别注意：可能复用线程
使用 ThreadPoolExecutor 时，线程被复用，子任务并非总由新线程执行。InheritableThreadLocal 的值不会在每次 submit() 时自动刷新 —— 它只在线程第一次启动时从父线程继承一次。若线程之前执行过其他任务，其 InheritableThreadLocal 可能残留旧值。
- 推荐做法：在提交任务前手动清理或重设，例如用
ThreadLocal#remove()配合包装逻辑 - 更稳妥方案：使用支持上下文传递的工具库（如 Alibaba 的
TransmittableThreadLocal）
自定义线程工厂可增强控制
若需统一处理继承逻辑（比如只传部分 key、做深拷贝、过滤 null 值），可重写 InheritableThreadLocal.childValue(T parentValue) 方法：
- 覆盖该方法可对继承值做转换，例如返回副本对象而非引用，避免共享可变状态
- 返回
null表示不向子线程传递该值（默认行为是直接返回 parentValue）
替代方案：TransmittableThreadLocal（推荐生产环境）
InheritableThreadLocal 对线程池支持弱，实际项目中更常用 TransmittableThreadLocal（TTL）：
- 兼容所有线程池（包括
ForkJoinPool、CompletableFuture） - 提供
TtlRunnable/TtlCallable包装器，显式传递上下文 - 支持异步链路透传，适合微服务 TraceID、用户上下文等场景
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
