MDC默认不继承到子线程，需手动拷贝或使用TTL等方案实现透传。可通过getCopyOfContextMap/setContextMap手动传递、封装MdcAwareRunnable、配置支持MDC的线程池、为CompletableFuture指定自定义执行器，或引入TtlMDCAdapter实现全自动透传。
MDC（Mapped Diagnostic Context）是 Logback 和 Log4j 提供的线程局部上下文机制，用于在日志中添加动态、线程隔离的键值对（如 traceId、userId）。但 MDC 默认不继承到子线程，因为它是基于 ThreadLocal 实现的，而子线程会创建新的 ThreadLocal 实例，父线程的 MDC 内容不会自动复制过去。
手动拷贝 MDC 到子线程
最直接的方式是在创建子线程前，显式获取当前线程的 MDC 内容，并在子线程中设回：
// 主线程中
MDC.put("traceId", "abc123");
MDC.put("spanId", "span-01");
// 启动子线程时手动传递
Map<String, String> context = MDC.getCopyOfContextMap(); // 获取副本
new Thread(() -> {
if (context != null) {
MDC.setContextMap(context); // 设入子线程
}
try {
log.info("子线程日志，带 traceId"); // ✅ 能输出 traceId
} finally {
MDC.clear(); // 避免内存泄漏（尤其在线程池中）
}
}).start();
使用线程池时用包装类自动传递
若大量使用线程池（如 ThreadPoolExecutor），推荐封装一个支持 MDC 继承的 Runnable 或使用装饰器：
- 继承
ThreadPoolExecutor，重写newTaskFor(Runnable)方法，在任务包装时捕获并注入 MDC - 更简单：用现成工具类，如
org.slf4j.MDC官方推荐的MDCInheritableThreadLocal（Logback 1.3+ 支持），或 Spring 的ThreadPoolTaskExecutor（默认已启用 MDC 继承） - 手动包装 Runnable 示例：
public class MdcAwareRunnable implements Runnable {
private final Runnable delegate;
private final Map<String, String> mdcContext;
public MdcAwareRunnable(Runnable delegate) {
this.delegate = delegate;
this.mdcContext = MDC.getCopyOfContextMap();
}
@Override
public void run() {
Map<String, String> old = MDC.getCopyOfContextMap();
if (mdcContext != null) {
MDC.setContextMap(mdcContext);
} else {
MDC.clear();
}
try {
delegate.run();
} finally {
if (old != null) {
MDC.setContextMap(old);
} else {
MDC.clear();
}
}
}
}
// 使用：
executor.submit(new MdcAwareRunnable(() -> log.info("带上下文的日志")));
用 CompletableFuture 时注意 MDC 不自动传递
CompletableFuture 的异步方法（如 supplyAsync、thenApplyAsync）默认使用 ForkJoinPool.commonPool()，MDC 不会继承。解决方式有：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
- 显式传入自定义线程池（该池已配置 MDC 支持）
- 用
copyOnComplete工具方法包装 Supplier/Function（需自己实现或引入slf4j-mdc-ttl等库） - 推荐：用
CompletableFuture.supplyAsync(() -> { ... }, executor)，其中executor是你封装好的 MDC 感知线程池
使用 TtlMDCAdapter（推荐用于复杂场景）
如果项目中存在大量异步调用（线程池、CompletableFuture、Dubbo、RocketMQ 等），手动维护容易遗漏。可引入 Transmittable Thread Local（TTL） 生态：
- 添加依赖：
com.alibaba:transmittable-thread-local - 替换 SLF4J 的 MDC 实现为 TTL 版本：
TtlMDCAdapter - 初始化（通常在应用启动时）：
MDC.mdcAdapter = new TtlMDCAdapter(); // 替换默认实现
之后所有子线程、ForkJoinTask、CompletableFuture 异步执行等，MDC 自动透传，无需额外代码。
