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></pattern> 中加入 %X{traceId}：

%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - traceId:%X{traceId} - %msg%n

Log4j2 对应使用 %X{traceId}（格式器为 PatternLayout），效果相同。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

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 缺失或错乱。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南