transmittablethreadlocal（ttl）专为解决线程池中上下文“传不下去、留不住、互相污染”而设计，通过任务提交时捕获快照、执行前注入、执行后还原，实现任务级上下文传递；正确使用须同时满足：声明变量用transmittablethreadlocal且线程池经ttlexecutors包装。
TransmittableThreadLocal（TTL）不是用来替代 ThreadLocal 的，而是专为解决线程池中上下文“传不下去、留不住、互相污染”这三类问题而生。它不改变线程模型，也不要求你改写业务逻辑，核心在于：把“线程上下文”升级为“任务上下文”，让每次提交的任务自带快照。
为什么 InheritableThreadLocal 在线程池里失效
InheritableThreadLocal 的继承动作只发生在 new Thread() 那一刻——父线程的 inheritableThreadLocals 被浅拷贝给子线程。但线程池里的线程是提前创建、反复复用的“老员工”，任务 B 提交时不会触发继承，自然拿不到任务 A 设置的值；更危险的是，如果任务 A 没 clean 掉 ThreadLocal，任务 B 就可能读到残留脏数据。
- FixedThreadPool 中的线程生命周期远长于单个任务
- Spring 的 ThreadPoolTaskExecutor、ForkJoinPool 同样适用该规律
- 常见症状：TraceId 错乱、用户身份串号、国际化 locale 失效
TransmittableThreadLocal 的工作方式
TTL 的本质是“任务增强 + 上下文快照”。它不依赖线程创建时机，而是在任务被提交的瞬间捕获当前线程所有 TTL 变量的值，并在任务真正执行前还原到目标线程中。
- 使用 TtlRunnable.get(runnable) 或 TtlCallable.get(callable) 包装任务
- 底层调用 Transmitter.capture() 把当前线程的 TTL 值序列化为一个快照对象
- 执行时通过 replay() 将快照注入目标线程的 ThreadLocal，执行完再用 restore() 清理还原
- 整个过程对业务代码透明，无需手动 set/remove
正确使用的两个必要条件
只换掉 ThreadLocal 为 TransmittableThreadLocal 是不够的——必须同时满足以下两点，否则依然会失效：
- 声明变量时使用 new TransmittableThreadLocal()，而非普通 ThreadLocal 或 InheritableThreadLocal
- 线程池必须经过包装：用 TtlExecutors.getTtlExecutorService(yourExecutor) 替换原始线程池实例
- 若使用 Spring，推荐配合 @Bean 定义包装后的线程池，避免硬编码
进阶支持与注意事项
TTL 还提供零侵入接入能力，适合中间件或基础组件团队统一治理：
- 支持 Java Agent 方式：添加 JVM 参数 -javaagent:transmittable-thread-local-2.11.4.jar，自动织入所有线程池提交逻辑
- 注意内存泄漏风险：TTL 内部持有 WeakReference，但仍建议在 finally 块中显式 remove()，尤其在 long-running 任务中
- 不兼容某些特殊线程池实现（如自定义拒绝策略未调用 run() 的场景），需实测验证
