spring多线程异步任务中threadlocal上下文不会自动传递，需通过taskdecorator自动捕获还原或手动传递并清理，务必在子线程结束前调用remove()防止污染。
在 Spring 的多线程异步任务中，ThreadLocal 上下文不会自动传递——因为子线程与主线程是独立的，各自拥有自己的 ThreadLocalMap。直接使用 @Async 或线程池执行任务时，原请求线程中存的用户信息、traceId、SecurityContext 等都会丢失。解决的关键不是“绕过”，而是“可控交接”。
用 TaskDecorator 自动捕获并恢复上下文
这是 Spring 官方推荐、生产环境最稳妥的方式。它在任务被线程池执行前，把主线程的上下文“快照”下来，并在子线程启动时自动还原。
- 定义一个装饰器，实现
TaskDecorator接口，在decorate()中完成上下文复制 - 将该装饰器注入到
ThreadPoolTaskExecutor的setTaskDecorator()方法中 - 所有经该线程池提交的 @Async 任务，都会被自动包装，无需修改业务代码
示例（以 traceId 为例）：
public class ContextCopyingDecorator implements TaskDecorator {@Override
public Runnable decorate(Runnable runnable) {
String traceId = MDC.get("traceId"); // 捕获当前上下文
return () -> {
try {
if (traceId != null) MDC.put("traceId", traceId);
runnable.run();
} finally {
MDC.remove("traceId"); // 清理防止污染后续任务
}
};
}
}
手动传递：适合简单或临时场景
当无法改造线程池配置，或只在个别地方需要异步时，可显式读取、传参、再设置。
- 在主线程中调用
ThreadLocal.get()获取值 - 把该值作为参数传入异步任务（例如封装成 Lambda 的闭包变量，或构造带参 Runnable）
- 子线程内调用
ThreadLocal.set(value)，并在 finally 块中remove()
注意：若用线程池，必须每次任务都清理，否则旧值可能残留；忘记 remove 是内存泄漏常见原因。
统一管理上下文工具类
避免每个 ThreadLocal 都重复写 copy/clear 逻辑，建议封装通用工具：
- 提供静态方法
copyToNewThread()，内部遍历已注册的上下文项（如 traceId、user、tenantId） - 配合 InheritableThreadLocal 不适用：它仅对
new Thread()有效，对线程池无效 - 可结合 Spring 的
RequestContextHolder或自定义ContextHolder类做抽象
务必清理 ThreadLocal
无论用哪种方式，子线程结束前都要调用 remove()。
- 线程池中线程复用，不清理会导致本次任务的上下文污染下次任务
- 尤其在 Web 应用中，一次请求结束后未 clear，可能让下一个用户看到上一个用户的日志或权限信息
- 最佳实践是用 try-finally 包裹异步任务体，确保 remove 执行
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
