Java多线程异步任务中传递TraceId需解决MDC跨线程丢失问题，可通过手动捕获还原MDC快照、使用TransmittableThreadLocal（TTL）、适配CompletableFuture及集成Sleuth/Micrometer Tracing实现可靠透传。
在 Java 多线程异步任务中传递日志 TraceId，核心是让 MDC（Mapped Diagnostic Context）的上下文能跨线程延续，因为默认情况下 ThreadLocal 不会自动传递到新线程。
使用 MDC + 自定义线程池包装器
MDC 本质依赖 ThreadLocal，子线程不会继承父线程的 MDC 数据。解决办法是在提交任务前捕获当前 MDC，再在线程执行时主动还原。
- 用 org.slf4j.MDC.getCopyOfContextMap() 获取当前线程的 MDC 快照
- 将快照作为闭包变量传入 Runnable/Callable，或封装进自定义任务类
- 在线程 run() / call() 开头调用 MDC.setContextMap(快照)，结尾调用 MDC.clear() 防止内存泄漏
借助 TransmittableThreadLocal（推荐）
阿里开源的 TransmittableThreadLocal（TTL） 是专为解决 ThreadLocal 跨线程传递设计的，比手动管理更可靠。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 引入依赖：
com.alibaba:transmittable-thread-local - 将 TraceId 存入 TTL 实例（如
static final TransmittableThreadLocal<string> traceIdHolder = new TransmittableThreadLocal()</string>） - 在入口（如 Filter 或拦截器）设置值：
traceIdHolder.set(traceId) - 后续所有子线程（包括线程池、CompletableFuture）都能直接读取，无需额外传递
适配 CompletableFuture 异步链路
CompletableFuture 默认不继承 MDC 或 TTL，需显式处理：
立即学习“Java免费学习笔记（深入）”；
- 用 CompletableFuture.supplyAsync(Supplier, executor) 并传入包装后的线程池（见第一点）
- 或使用 TTL 提供的 TtlExecutors 包装线程池：
ExecutorService ttlExecutor = TtlExecutors.getTtlExecutorService(原executor) - 避免直接调用无参 supplyAsync()，它使用 ForkJoinPool.commonPool()，无法自动透传
框架层统一支持（Spring Boot 场景）
若项目基于 Spring Boot，可结合 Sleuth 或 Micrometer Tracing：
- Sleuth 会自动注入 TraceId 到 MDC，并通过 LazyTraceExecutor、TraceableExecutorService 等包装器支持线程池
- 启用
spring.sleuth.async.enabled=true，并确保异步方法使用 @Async 且配置了 trace-aware 的 TaskExecutor - 新版 Micrometer Tracing（替代 Sleuth）同样提供 TracingExecutorService 和对 CompletableFuture 的自动支持
