InheritableThreadLocal在线程池中无法传递，因其继承机制仅在new Thread()时通过init()触发，而线程池复用线程不新建线程，故不执行继承逻辑；TransmittableThreadLocal通过任务提交前copy快照、执行前replay恢复来绕过该限制。
为什么 InheritableThreadLocal 在线程池里传不下去
InheritableThreadLocal 的继承机制只在
时触发，靠的是子线程构造时调用
方法拷贝父线程的
表。但线程池里的线程是复用的，
提交任务时不会新建线程，也就不会触发继承逻辑——所以你往
里塞的 traceId，在
或
后的异步任务里永远是 null。
常见错误现象：
没引入时，日志里看到上游传了
，下游异步任务里打印出来却是
或旧值；或者用了
却发现定时任务、Dubbo 回调、CompletableFuture 异步块里链路断了。
不是线程没继承，是根本没走继承路径
哪怕手动调用
也无效——这个字段是 private final，且线程启动后不可变
JDK 本身不提供运行时“重放”继承的 API
TransmittableThreadLocal 是怎么绕过这个限制的
不依赖线程创建时机，而是把「快照」和「传播动作」拆开：在任务提交前捕获当前上下文（
），再通过装饰
/
，在执行前主动恢复。
核心机制是两层包装：
提交任务时，用
包一层原始
，它内部会调用
把当前线程的 TL 值深拷贝成一个
真正执行时，
先调用
把快照值设进当前线程，执行完再
回滚
注意：它不修改 JDK 底层，也不 hack 线程模型，纯靠任务封装 + TL 自身的
/
钩子实现。所以对
、
、Dubbo Filter、甚至自定义线程池都有效——只要你用
包装或显式 wrap。
从 InheritableThreadLocal 迁移到 TransmittableThreadLocal 的实操要点
不能只换类名，否则照样断链。关键在「哪里捕获」「哪里恢复」必须对齐。
把所有
替换为
线程池必须用
包装，不能直接用原始 pool；否则
依然不带快照
如果用
，必须写成
Spring
需配合
，替换掉默认的
或
包装实例
的
默认是浅拷贝，如果存的是可变对象（比如
），需重写该方法做深拷贝，否则下游修改会影响上游
示例片段：
容易被忽略的边界场景和性能代价
很多人以为换了
就一劳永逸，但以下情况仍会丢值：
使用
且未用
包装——它的 work-stealing 机制会让任务跨线程迁移，而标准包装不覆盖 fork/join 流程
Netty 的
线程里手动
任务，但没用
显式包装
异步回调中又起了新线程（比如回调里再
），此时得手动调用
，因为
只管池内线程
性能上，每次
都要序列化快照、每次执行都要 replay/restore，比原生
多 2~3 次哈希表操作。高并发异步场景下，建议只透传必要字段（如
、
），不要塞整个
或上下文对象。
最麻烦的其实是排查——一旦漏包一个线程池或一个回调点，链路就断在那儿，日志里看不出任何异常，只能靠全链路 traceId 是否连续来反向定位漏点。
new Thread()init()inheritableThreadLocalsThreadPoolExecutorInheritableThreadLocalsubmit()execute()TransmittableThreadLocaltraceId=abc123nullInheritableThreadLocalchildThread.inheritableThreadLocals = parent.inheritableThreadLocalsTransmittableThreadLocalTransmittableThreadLocal.copy()RunnableCallableTtlRunnable.get()RunnableTransmittableThreadLocal.copy()SnapshotTtlRunnableTransmittableThreadLocal.replay()restore()copy()beforeExecute()CompletableFuture@AsyncTtlExecutorsnew InheritableThreadLocal()new TransmittableThreadLocal()TtlExecutors.getTtlExecutorService(pool)submit()CompletableFuture.supplyAsync(() -> {}, pool)CompletableFuture.supplyAsync(() -> {}, TtlExecutors.getTtlExecutorService(pool))@AsyncTtlAsyncTaskExecutorSimpleAsyncTaskExecutorThreadPoolTaskExecutorTransmittableThreadLocalcopy()MapTransmittableThreadLocal traceIdHolder = new TransmittableThreadLocal<>();
// 正确：包装线程池
ExecutorService ttlPool = TtlExecutors.getTtlExecutorService(Executors.newFixedThreadPool(4));
ttlPool.submit(() -> {
System.out.println(traceIdHolder.get()); // 能拿到主线程设置的值
});
TransmittableThreadLocalForkJoinPoolTtlForkJoinPoolEventLoopexecute()TtlRunnable.get()new Thread().start()TtlRunnable.get()TtlExecutorssubmit()ThreadLocaltraceIdspanIdMDC