InheritableThreadLocal 仅在子线程创建时继承父线程值快照，不支持实时同步、多级继承及线程池复用场景，故常失效；需手动包装 Runnable 或改用 TransmittableThreadLocal。
为什么 InheritableThreadLocal 看似能传上下文，但常失效？
因为子线程只在创建时继承父线程的 InheritableThreadLocal 值快照，之后父线程修改、子线程再新建子线程、或使用线程池时都会断链。常见现象是：日志链路ID在异步任务里突然变成 null 或默认值，或者 Spring 的 RequestContextHolder 在 @Async 方法里拿不到请求上下文。
- 线程池中的线程是复用的，不是每次 new 出来的，所以不会触发「继承」逻辑
-
set()之后父线程再set()，子线程看不到新值（无实时同步） - 子线程里再开子线程，第二层不会自动继承第一层的值（除非手动透传）
怎么让 InheritableThreadLocal 在线程池中真正生效？
必须包装线程池的 Runnable，在执行前把父线程的 InheritableThreadLocal 值显式复制过去。Spring 的 ThreadPoolTaskExecutor 提供了 setThreadFactory 和 decorateTask 钩子，但最稳的方式是自己写一个带上下文透传的 Runnable 包装器。
- 不要直接往线程池 submit 原始
Runnable，而是用类似new ContextCopyingRunnable(runnable)包一层 - 包装器构造时捕获当前线程的
InheritableThreadLocal快照（用get()），run()里先set()再执行原逻辑，结束后remove()避免内存泄漏 - 如果用了多个
InheritableThreadLocal实例，每个都要单独做这套操作，不能靠一个通用 copy 方法自动识别
public class ContextCopyingRunnable implements Runnable {
private final Runnable delegate;
private final String traceId; // 示例：只透传 traceId
public ContextCopyingRunnable(Runnable delegate) {
this.delegate = delegate;
this.traceId = MDC.get("traceId"); // 或从自定义 InheritableThreadLocal 取
}
@Override
public void run() {
if (traceId != null) MDC.put("traceId", traceId);
try {
delegate.run();
} finally {
MDC.remove("traceId");
}
}
}
InheritableThreadLocal 和 TransmittableThreadLocal 怎么选？
如果你没被强制要求用 JDK 原生类，直接上 TransmittableThreadLocal（阿里 TTL 库）。它通过字节码增强或手动 hook 解决了线程池场景下的断链问题，且支持父子双向传递（比如子线程改值后父线程也能感知，虽然不常用）。
-
TransmittableThreadLocal要配合TtlExecutors包装线程池，否则和原生一样失效 - Spring Boot 项目里，可以用
@Bean替换默认的TaskExecutor，用TtlExecutors.getTtlExecutorService(pool)包装 - 注意 TTL 的
remove()时机：如果子线程执行时间长、又频繁调用其他异步逻辑，得确保每层都 clean，否则可能污染后续任务
哪些场景下 InheritableThreadLocal 根本不该用？
任何涉及线程复用、跨模块调用、或需要“动态更新传播”的地方，硬扛 InheritableThreadLocal 只会越修越乱。比如：WebFlux 的响应式链路、Dubbo 的隐式参数透传、或者基于 Netty 的自定义协议服务。
- 响应式编程（Mono/Flux）要用
ContextView+subscriberContext，不是线程本地变量的事 - Dubbo 有
RpcContext，Spring Cloud 有RequestAttributes+RequestContextHolder，它们内部早做了适配，别自己绕路 - 如果上下文要跨进程（比如发 MQ 消息），必须序列化进消息头，
InheritableThreadLocal连进程边界都出不去
真正可靠的上下文传递，从来不是靠“继承”，而是靠显式传递 + 框架集成。线程本地变量只是其中一环，而且是最容易误用的一环。
