mdc在异步线程中默认不传递，需手动捕获并还原上下文；解决方案包括：包装threadpooltaskexecutor、为completablefuture指定增强线程池、配置@async使用自定义executor，并确保logback pattern正确引用%x{}及调用mdc.clear()。
MDC（Mapped Diagnostic Context）在异步线程中默认不传递，是因为子线程无法自动继承父线程的 MDC 内容。在分布式日志系统（如基于 Logback + Sleuth 或自研链路追踪）中，若使用线程池、CompletableFuture、@Async 等异步机制，MDC 会丢失，导致日志中 traceId、spanId、userId 等关键上下文缺失。核心解决思路是：在任务提交前主动捕获 MDC，并在子线程执行前手动还原。
使用 Logback + ThreadPoolTaskExecutor 时的 MDC 透传
Spring 默认的 ThreadPoolTaskExecutor 不支持自动 MDC 传递。需包装线程池，使其在提交任务时快照父线程 MDC，并在子线程执行前注入：
- 定义一个继承
ThreadPoolTaskExecutor的类，重写execute(Runnable)和submit(Runnable)方法 - 在方法内调用
MDC.getCopyOfContextMap()获取当前 MDC 快照 - 将快照封装进 Runnable/Callable 包装器（如
MdcAwareRunnable），在run()中先MDC.setContextMap(...)，再执行原逻辑，结束后MDC.clear() - 确保线程池 bean 使用该增强类，而非原生
ThreadPoolTaskExecutor
CompletableFuture 异步场景下的 MDC 持续
CompletableFuture 的异步回调（如 thenApply、supplyAsync）运行在线程池（默认 ForkJoinPool）中，MDC 不会自动延续。推荐做法：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 避免直接使用
supplyAsync(() -> {...})，改用supplyAsync(() -> {...}, executor)并传入已增强的线程池 - 若必须用默认线程池，可借助
ThreadLocal+CompletableFuture.whenComplete手动传递，但易出错；更稳妥的是封装工具方法，如MdcUtils.withMdc(() -> doWork()) - 注意：
thenCompose、thenCombine等链式调用需每层都做 MDC 还原，否则中间节点仍可能丢失
Spring @Async 方法的 MDC 支持
@Async 底层依赖 TaskExecutor，只要配置的 executor 是前述增强版本，就能自动生效。关键配置步骤：
- 声明一个
@Bean返回自定义的MdcThreadPoolTaskExecutor - 通过
@EnableAsync启用异步，并用@Async("mdcExecutor")显式指定 bean 名 - 禁用 Spring Boot 自动配置的
SimpleAsyncTaskExecutor（它每次新建线程，MDC 无法复用） - 若使用 Kotlin 协程，需配合
CoroutineContext+MDCContext插件，而非依赖线程级 MDC
Logback 配置与注意事项
即使代码层完成透传，Logback 的 pattern 也要正确引用 MDC 字段，例如：
注意点：
-
%X{key:-}中的-表示 key 不存在时显示空字符串，避免日志出现%X{traceId}原样输出 - 每次异步任务结束前务必调用
MDC.clear()，防止线程复用时污染后续请求 - 若集成 Spring Cloud Sleuth，优先使用其内置的
TraceThreadLocalSpanExtractor和LazyTraceExecutor，它们已对 MDC 透传做了完整适配
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
