TransmittableThreadLocal（TTL）是专为解决线程池复用场景下ThreadLocal上下文丢失而设计的增强方案，通过Capture→Replay→Restore三步机制实现跨线程上下文传递，支持任务级包装或线程池级代理两种接入方式，需声明为static final并注意内存泄漏风险。
ThreadLocal 本身不能解决异步线程池中的上下文丢失问题，它恰恰是这个问题的根源。真正起作用的是它的增强方案——TransmittableThreadLocal（TTL）。它不是 ThreadLocal 的替代品，而是专为“跨线程池复用场景”设计的上下文传递补丁。
为什么原生 ThreadLocal 在线程池里必然失效
ThreadLocal 数据绑定在当前 Thread 实例上。线程池中的工作线程被反复使用，每次执行新任务时，它携带的是自己上次留下的 ThreadLocal 值，而不是提交任务那个线程的值。InheritableThreadLocal 虽能传给子线程，但对线程池无效——因为线程池不创建新线程，只是唤醒已有线程。
TransmittableThreadLocal 的核心机制
TTL 不靠继承，而是采用 Capture → Replay → Restore 三步策略：
- Capture：在主线程提交任务前，快照当前所有 TTL 变量的值
- Replay：任务在工作线程执行前，把快照值设入该线程的 TTL 中
- Restore：任务执行完毕后，自动恢复该线程原来的 TTL 值，避免污染后续任务
两种主流接入方式，按需选择
方式一：包装单个任务（适合少量、分散调用）
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
- 用
TtlRunnable.get(() -> {...})包装 Runnable - 用
TtlCallable.get(() -> "result")包装 Callable - 必须在
set()完成后再调用get()，否则捕获不到值
方式二：包装整个线程池（推荐用于全局治理）
- 用
TtlExecutors.getTtlExecutorService(executor)获取代理对象 - 之后所有
submit()、execute()、invokeAll()都自动透传 - 一次替换，全项目生效，零业务侵入
使用时的关键细节
声明 TTL 变量要遵循规范：
- 必须是
static final，保证单例和线程安全 - 值类型尽量用不可变对象（如 String、Long、自定义只读 DTO）
- 避免存大对象或 Request/Response 实例，防止内存泄漏
- 建议在任务结束时显式调用
ttl.remove()，尤其在长生命周期线程中
