MDC是SLF4J/Logback基于ThreadLocal实现的线程上下文传递机制，用于日志自动携带traceId等信息；需在Web入口初始化并及时清理，异步任务须显式透传快照，Spring @Async需TaskDecorator支持，日志格式需配置%X{}占位符。
MDC（Mapped Diagnostic Context）是 SLF4J/Logback 等日志框架提供的线程级上下文传递机制，核心是用 ThreadLocal 为每个线程维护一个独立的 Map，让日志自动携带如 traceId、userId、sessionId 等关键信息。它不改变日志内容本身，而是让日志格式模板能动态填入上下文值。
在同步请求中设置和清理 MDC
Web 请求入口（如 Filter 或 Interceptor）是最常见的初始化位置。需确保写入后及时清理，避免线程复用导致上下文污染。
- 生成唯一标识（如 UUID），调用 MDC.put("traceId", id) 写入当前线程上下文
- 业务逻辑执行完毕后，必须调用 MDC.remove("traceId") 或 MDC.clear() 清理
- 推荐用 try-finally 或 try-with-resources 包裹，防止异常跳过清理
在线程池异步任务中透传 MDC
线程池复用线程，子线程不会自动继承父线程的 MDC。必须显式捕获 + 恢复 + 清理。
- 提交任务前，调用 MDC.getCopyOfContextMap() 获取不可变快照（不是引用）
- 在 Runnable/Callable 的 run/call 方法开头，用 MDC.setContextMap(map) 恢复上下文
- 务必在 finally 块中执行 MDC.clear()，防止残留数据影响后续任务
- 可封装成 MdcAwareRunnable 装饰器，或通过自定义 ThreadFactory 统一处理
在 Spring @Async 中自动透传
Spring 的 @Async 默认不支持 MDC 继承，需借助 TaskDecorator 实现透明透传。
立即学习“Java免费学习笔记（深入）”；
- 定义 Bean：继承 ThreadPoolTaskExecutor，重写 setTaskDecorator
- 装饰器中捕获当前 MDC 快照，并在新线程执行前 setContextMap
- 配合 @EnableAsync 和自定义配置生效，无需修改业务代码
日志输出格式中引用 MDC 值
仅设置 MDC 不够，还需在 logback-spring.xml 或 log4j2.xml 中配置占位符，日志框架才会渲染。
- Logback 示例：%d{HH:mm:ss.SSS} [%X{traceId}] [%thread] %-5level %logger{36} - %msg%n
- %X{traceId} 表示从 MDC 取 key=traceId 的值；若不存在则留空，不报错
- 微服务场景下，还需通过 HTTP Header（如 X-Trace-ID）在服务间传递 traceId，再由下游服务写入自身 MDC
