mdc在completablefuture异步线程中丢失是因为其基于threadlocal，而forkjoinpool线程不继承父线程上下文；需手动通过getcopyofcontextmap捕获、setcontextmap还原，并用finally调用clear防止内存泄漏。
在 CompletableFuture 的异步线程中透传 MDC（Mapped Diagnostic Context）需要手动捕获和还原上下文，因为 MDC 基于 ThreadLocal，而默认的 ForkJoinPool 线程不继承父线程的 MDC 内容。
为什么 MDC 会丢失？
MDC 本质是 ThreadLocal<map string>></map>，只绑定当前线程。CompletableFuture 默认使用 ForkJoinPool.commonPool()，其线程与提交任务的线程无关，MDC 不会自动复制过去。
手动透传 MDC 的核心方法
在调用 supplyAsync、thenApply 等异步方法前，先获取当前线程的 MDC 内容；在异步任务执行时，主动 set 进去，并在结束后 clear，避免内存泄漏：
- 用
MDC.getCopyOfContextMap()捕获当前上下文（返回一个新 Map） - 在异步 lambda 中调用
MDC.setContextMap(...)还原 - 务必用
try-finally或try-with-resources（配合自定义工具类）确保MDC.clear()
封装可复用的工具方法
推荐封装一个静态工具类，简化写法：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
<font size="2"><pre class="brush:php;toolbar:false;">public class MdcUtils {
public static <t> CompletableFuture<t> supplyAsyncWithMdc(Supplier<t> supplier) {
Map<string string> context = MDC.getCopyOfContextMap();
return CompletableFuture.supplyAsync(() -> {
if (context != null) MDC.setContextMap(context);
try {
return supplier.get();
} finally {
MDC.clear();
}
});
}
public static <t r> CompletableFuture<r> thenApplyWithMdc(
CompletableFuture<t> future, Function<t r> fn) {
Map<string string> context = MDC.getCopyOfContextMap();
return future.thenApply(t -> {
if (context != null) MDC.setContextMap(context);
try {
return fn.apply(t);
} finally {
MDC.clear();
}
});
}
}</string></t></t></r></t></string></t></t></t>
使用示例：
<font size="2"><pre class="brush:php;toolbar:false;">MDC.put("traceId", "abc123");
CompletableFuture<string> f = MdcUtils.supplyAsyncWithMdc(() -> {
log.info("异步中打印日志"); // traceId 可见
return "done";
});</string>
更彻底的方案：自定义 Executor + 统一包装
如果项目大量使用 CompletableFuture，建议创建一个带 MDC 透传能力的 Executor：
- 包装任意
Executor，在execute(Runnable)前 capture MDC，在 run 时 restore & clear - 所有
supplyAsync(..., executor)都用这个 executor - Spring Boot 用户可直接配置
@Bean Executor taskExecutor()并注入到 CompletableFuture 调用中
这样无需每个地方都手动处理，也兼容 thenAccept、runAsync 等各类方法。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
