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 TransmittableThreadLocalstatic final 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）：
@Beanpublic 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(); // 关键！
}
}
}
