mdc在多线程异步调用中无法自动传递，因其依赖threadlocal，子线程不继承父线程mdc；需通过手动快照透传还原、transmittablethreadlocal或框架层（如sleuth、micrometer）统一治理实现上下文传递。
MDC 在多线程异步调用中无法自动传递，根本原因是它底层依赖 ThreadLocal，而子线程、线程池任务、CompletableFuture 等新线程不会继承父线程的 MDC 数据。要让 traceId 等上下文在异步链路中持续生效，必须显式完成“捕获—透传—还原”三个动作。
手动快照 + 包装任务（轻量可控）
适用于自定义线程池或少量异步逻辑，不引入额外依赖。
- 提交任务前调用
MDC.getCopyOfContextMap()获取当前上下文快照 - 将快照作为闭包变量传入
Runnable或Callable，或封装进任务包装类 - 在线程执行体开头调用
MDC.setContextMap(快照)，结尾务必MDC.clear()防止内存泄漏和上下文污染 - 注意：lambda 表达式需显式捕获快照，不能直接引用 MDC.put 后的值
用 TransmittableThreadLocal（推荐主流方案）
TTL 是阿里开源的增强型 ThreadLocal，能自动跨线程（包括线程池、ForkJoinPool、虚拟线程）透传数据，比手动管理更可靠。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 引入依赖：
com.alibaba:transmittable-thread-local - 声明静态 TTL 实例：
static final TransmittableThreadLocal<string> traceIdHolder = new TransmittableThreadLocal();</string> - 在请求入口（如 Filter、Interceptor）设置：
traceIdHolder.set(MDC.get("traceId")); - 下游所有子线程可直接读取：
traceIdHolder.get()，无需重复设置或清理
适配 CompletableFuture 和 @Async
CompletableFuture 默认使用 ForkJoinPool.commonPool()，@Async 默认用普通线程池，两者都不支持 MDC/TTL 自动继承。
- 禁用无参
supplyAsync(() -> ...)，改用带 executor 的重载，并确保该 executor 已被 TTL 包装：TtlExecutors.getTtlExecutorService(originalPool) - Spring Boot 中启用
@EnableAsync后，配置TaskExecutor时使用LazyTraceExecutor（Sleuth）或TracingExecutorService（Micrometer Tracing） - 若用
@Scheduled，需在方法开头检查：if (MDC.get("traceId") == null) { MDCTraceUtils.addTraceId(); }
框架层统一治理（适合中大型项目）
避免散落在各处的手动处理，交由框架自动接管上下文传播。
- Spring Cloud Sleuth：启用
spring.sleuth.async.enabled=true，配合@Async和自定义TaskExecutor即可自动注入 traceId 到 MDC - Micrometer Tracing（Sleuth 替代方案）：集成后默认支持线程池、CompletableFuture、虚拟线程等场景，只需配置 tracing bean
- 自定义
TaskDecorator（Spring Boot）：在ThreadPoolTaskExecutor中设置装饰器，统一完成 MDC 快照与还原，一次配置全局生效
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
