TransmittableThreadLocal（TTL）通过Capture→Replay→Restore三步机制实现跨线程上下文传递，需声明为static final、使用不可变对象，配合TtlRunnable/TtlCallable包装或TtlExecutors增强线程池，并在任务结束时调用remove()清理。

TransmittableThreadLocal（TTL）专为解决跨线程、跨线程池场景下的上下文丢失而设计。它不是简单“继承”父线程变量，而是通过Capture（捕获）→ Replay（回放）→ Restore（恢复）三步机制，在任务提交与执行之间精准传递上下文，同时避免线程污染。

用对 ThreadLocal 替代品：声明 TTL 实例

所有需要透传的上下文字段，必须使用 TransmittableThreadLocal 替代原生 ThreadLocal：

• 声明为 static final，确保单例和线程安全
• 值类型建议为不可变对象（如 String、Long、自定义不可变 DTO），避免共享可变状态
• 避免存储大对象（如完整 Request 对象），防止内存泄漏或 GC 压力

示例：

static final TransmittableThreadLocal traceId = new TransmittableThreadLocal();
static final TransmittableThreadLocal userId = new TransmittableThreadLocal();

任务提交前包装：TtlRunnable / TtlCallable

这是最常用、侵入性最小的方式。只要在向线程池提交任务前做一层包装，就能自动携带上下文：

• 对 Runnable：用 TtlRunnable.get(() -> { ... }) 包装
• 对 Callable：用 TtlCallable.get(() -> "result") 包装
• 包装操作必须在主线程上下文已设置完成之后执行（即 set() 后再 get()）

示例：

traceId.set("TRACE-1001");
userId.set(123L);

// 提交到线程池
executor.submit(TtlRunnable.get(() -> {
  System.out.println("trace: " + traceId.get()); // TRACE-1001
  System.out.println("user: " + userId.get()); // 123
}));

全局生效：包装线程池本身

若项目中大量使用同一类线程池（如业务线程池、定时任务池），推荐用 TtlExecutors 一次性增强，无需逐个包装任务：

• 调用 TtlExecutors.getTtlExecutorService(originalExecutor) 获取代理实例
• 后续所有 submit()、execute()、invokeAll() 等操作均自动透传
• Spring 场景下，可在配置类中直接替换 @Bean 返回值

示例（Spring Boot）：

@Bean
public ExecutorService bizExecutor() {
  return TtlExecutors.getTtlExecutorService(
    Executors.newFixedThreadPool(8)
  );
}

关键收尾动作：及时清理与隔离

TTL 虽自动 restore，但不等于无需管理。以下两点直接影响稳定性：

• 务必在请求/任务结束时 remove()：尤其在 Web Filter 或 AOP 切面中，避免线程复用导致旧上下文残留
• 禁止在子线程中修改 TTL 值后不清理：虽然子线程 set 不影响父线程，但若未 remove，该线程下次被复用时可能误带旧值
• 可配合 try-finally 或 TTL 提供的 ttlRun() 工具方法保障清理

示例（Web 入口）：

public class TraceFilter implements Filter {
  public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) {
    try {
      traceId.set(generateTraceId());
      chain.doFilter(req, res);
    } finally {
      traceId.remove(); // 关键！
    }
  }
}