Java多线程日志追踪需用MDC结合上下文传递：入口设traceId并try-finally清理，线程池需手动复制MDC快照，Spring推荐Sleuth/Micrometer自动透传，避坑包括勿重复造轮子、显式包装并行流、WebFlux改用Reactor Context。
在 Java 多线程环境下，日志中打印追踪标识（如请求 ID、trace ID）的关键是让每个线程拥有独立且可传递的上下文，避免不同请求或任务的日志混杂。最常用、最可靠的方式是结合 MDC（Mapped Diagnostic Context） 与线程上下文传递机制。
用 MDC 绑定和清理追踪 ID
MDC 是 SLF4J 提供的线程级 Map，底层基于 ThreadLocal，天然支持线程隔离。你可以在任务开始时放入 trace ID，在结束时主动清除：
- 在入口处（如 WebFilter、拦截器、任务提交前）生成唯一 ID（例如用
UUID.randomUUID().toString()），并放入 MDC：MDC.put("traceId", "req-abc123"); - 确保在 try-finally 或 try-with-resources 中清理，防止线程复用导致脏数据：
try { ... } finally { MDC.remove("traceId"); } - Logback 配置中，在 pattern 中引用：
%X{traceId:-N/A}（-N/A是默认值，防空）
跨线程传递 MDC 内容
普通线程池（如 ThreadPoolExecutor）不会自动复制父线程的 MDC，需手动包装 Runnable/Callable：
- 使用
org.slf4j.MDC.getCopyOfContextMap()获取当前上下文快照 - 在新线程执行前，调用
MDC.setContextMap(...)恢复；执行后调用MDC.clear() - 推荐封装一个
MDCRunnable或使用现成工具类（如net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder不负责传递，但logback-classic本身不自动传递） - Spring 环境下可用
@Async配合自定义AsyncConfigurer，返回带 MDC 透传能力的ThreadPoolTaskExecutor
集成分布式链路追踪（如 Sleuth / Micrometer Tracing）
若项目已接入 Zipkin / Jaeger / SkyWalking，建议直接用成熟方案替代手写 MDC：
立即学习“Java免费学习笔记（深入）”；
- Spring Cloud Sleuth 会自动注入
traceId和spanId到 MDC，并支持线程池、CompletableFuture、RabbitMQ 等场景的上下文传播 - 只需引入依赖 + 配置 logback pattern：
%X{traceId:-},%X{spanId:-} - Micrometer Tracing（Sleuth 的继任者）同样提供开箱即用的 MDC 集成和跨线程支持
注意点与避坑提醒
- 别只靠 ThreadLocal 自己存：MDC 已经是封装好的 ThreadLocal，直接用它，不要重复造轮子
- 勿在 Lambda 表达式里隐式捕获 MDC：Stream.parallelStream() 或 ForkJoinPool 默认不传 MDC，需显式包装
- 异步日志框架（如 Log4j2 AsyncLogger）不影响 MDC 正常工作，只要 MDC 在日志语句执行时仍存在即可
- WebFlux 或 Project Reactor 场景要用 reactor.util.context.Context + 自定义日志适配，MDC 失效（因非 ThreadLocal 模型）
