mdc泄漏本质是线程复用时threadlocal中map未清理导致值残留，污染日志并引发内存泄漏或敏感信息泄露；需在请求入口/出口、异步任务、线程池等场景通过try-finally、装饰器或自动清理机制确保mdc.clear()执行。
Java 中 MDC（Mapped Diagnostic Context）上下文未清理导致的泄漏，本质是线程复用场景下，MDC 中的 Map 被意外继承并长期残留，污染后续请求日志，甚至引发内存泄漏或敏感信息泄露。关键在于：MDC 是基于 ThreadLocal 实现的，而线程池中的线程被反复使用，若忘记手动清除，旧值就会“粘”在上面。
确认是否真存在 MDC 泄漏
不要一上来就查代码，先验证现象：
- 观察日志中是否出现「不该出现的字段」——比如 A 请求设置了
traceId=abc，B 请求（无 traceId）的日志里却也打印了traceId=abc - 在关键入口（如 Spring MVC 的
HandlerInterceptor.preHandle）和出口（afterCompletion）打点检查：MDC.getCopyOfContextMap()，看进入时是否为空、退出时是否已清空 - 用 JVM 工具采样：通过
jstack或 Arthas 查看线程堆栈，再结合ognl命令 inspect 线程的inheritableThreadLocals字段，确认是否有非空的MDC$1（即LogbackMDCAdapter实例）
重点排查位置：线程生命周期不匹配处
MDC 清理必须与线程“逻辑生命周期”对齐，常见失配点：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
异步线程未传递或未清理：比如用了
CompletableFuture.supplyAsync()、new Thread()、或自定义线程池提交任务，但没显式调用MDC.copy() / MDC.clear() -
Filter/Interceptor 缺少 finally 清理：Spring 的
OncePerRequestFilter或 WebMvc 的拦截器中，只在preHandle放入 MDC，却在异常路径下跳过afterCompletion，导致未清除 -
线程池未做 MDC 隔离：Tomcat 等容器线程池复用请求线程，若某次请求未清理 MDC，下次分配到该线程的请求就会继承旧值；需确保每次请求结束前
MDC.clear() - RPC/消息消费端遗漏：Dubbo、Feign、RocketMQ Listener 等回调线程中设置了 MDC，但没有配套清理逻辑
推荐的防御性写法
别依赖人工记忆「记得 clear」，用结构化方式兜底：
-
Web 层统一拦截：用
OncePerRequestFilter，在doFilterInternal中try-finally包裹链路，并在 finally 里MDC.clear() -
异步任务包装工具类：
```java
public static
CompletableFuture withMdc(CompletableFuture future) { Map mdc = MDC.getCopyOfContextMap(); return future.whenComplete((r, t) -> MDC.setContextMap(mdc)) .thenApply(r -> { MDC.clear(); return r; }); } ``` -
线程池装饰器：用
ThreadFactory包装线程，在run()前拷贝父线程 MDC，执行完自动清空（类似 Logback 的AsyncAppender内部机制） -
启用 Logback 自动清理（慎用）：Logback 1.3+ 支持
<configuration reset="true"></configuration>+include="org/slf4j/impl/StaticLoggerBinder"，但仅限新项目，老版本不生效
辅助诊断手段
加一层“安全网”，让问题暴露得更快：
- 在应用启动时设置
MDC.put("mdc-check", "init")，并在每次请求入口校验是否存在该 key —— 若存在，说明上个请求未清理 - 写一个定时任务，定期扫描活跃线程的
MDC内容，发现非空且包含业务字段（如userId、traceId）时告警 - 用 ByteBuddy 或 Java Agent 在
MDC.put()和MDC.clear()方法上埋点，统计调用次数差，快速定位漏调用点
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
