Java中MDC实现全链路追踪ID打印的核心是将traceId存入当前线程MDC并在日志中输出，需在请求入口生成并注入、配置日志框架格式、手动跨线程传递、集成链路追踪框架，并注意MDC清理与透传。
Java 中使用 MDC（Mapped Diagnostic Context）打印全链路追踪 ID，核心是把唯一标识（如 traceId）存入当前线程的 MDC 上下文，并确保日志框架（如 Logback、Log4j2）在输出日志时自动将其写入日志行。
1. 生成并注入 traceId 到 MDC
通常在请求入口（如 Spring Boot 的 Filter 或 WebMvcConfigurer）中生成 traceId 并放入 MDC：
- 使用 UUID、Snowflake 或 OpenTracing/Spring Cloud Sleuth 提供的 traceId
- 调用
MDC.put("traceId", traceId)将其绑定到当前线程 - 务必在请求结束时调用
MDC.clear()，防止线程复用导致脏数据（尤其在 Tomcat 线程池中）
2. 配置日志框架输出 traceId
以 Logback 为例，在 logback-spring.xml 的 <pattern> 中加入 %X{traceId}：
Log4j2 对应使用 %X{traceId}（格式器为 PatternLayout），效果相同。
立即学习“Java免费学习笔记（深入）”；
3. 跨线程传递 traceId
MDC 默认只在当前线程有效。异步操作（如 CompletableFuture、线程池任务）需手动传递：
- 使用
MDC.getCopyOfContextMap()获取当前上下文快照 - 在线程创建前调用
MDC.setContextMap(...)恢复 - Spring Boot 项目可借助
@Async+ 自定义ThreadPoolTaskExecutor，重写execute方法自动透传 MDC
4. 与主流链路追踪框架集成
若已接入 SkyWalking、Pinpoint 或 Spring Cloud Sleuth，无需手动生成 traceId：
- Sleuth 自动将
traceId和spanId写入 MDC，键名为traceId和spanId - SkyWalking 提供
TraceContext.traceId()，可主动 put 到 MDC（需引入apm-toolkit-logback-1.x.jar） - 确保日志配置中对应字段名一致（如
%X{traceId}），否则无法显示
不复杂但容易忽略的是 MDC 清理和跨线程传递——漏掉任一环节都可能导致日志中 traceId 缺失或错乱。
