Spring MVC非Boot项目中MDC变量无法在Log4j2中访问

核心原因 #

依赖使用的是Log4j 2.x，但代码中导入的是Log4j 1.x的org.apache.log4j.MDC类，两套日志框架的MDC上下文相互独立，Log4j 2无法读取Log4j 1 MDC中设置的变量值，导致日志中X_REQUEST_ID位置为空。

解决步骤 #

1. 替换MDC类导入
   将代码中的import org.apache.log4j.MDC;替换为Log4j 2的MDC类：

   import org.apache.logging.log4j.MDC;
   

   （注：Log4j 2中MDC是ThreadContext的别名，也可以直接使用ThreadContext）

2. 修正MDC调用方法
   Log4j 2的MDC使用put方法设置变量（Log4j 1用set），调整代码为：

   MDC.put("X_REQUEST_ID", UUID.randomUUID().toString());
   

3. 保留现有日志配置
   当前log4j2.xml中的日志格式配置[%X{X_REQUEST_ID}]是正确的，无需修改：

   %d{yyyy-MMM-dd HH:mm:ss.SSSSSS} [%X{X_REQUEST_ID}] [%t] %-5p %c
   

4. 清理冲突依赖
   检查项目依赖，若存在Log4j 1的log4j:log4j依赖，需排除避免冲突：

   <dependency>
       <!-- 示例：排除其他依赖中引入的Log4j 1 -->
       <groupId>xxx</groupId>
       <artifactId>xxx</artifactId>
       <exclusions>
           <exclusion>
               <groupId>log4j</groupId>
               <artifactId>log4j</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   

5. 添加MDC上下文清理
   在Filter的doFilter方法末尾添加清理逻辑，防止线程池复用导致的上下文污染：

   try {
       // 原有设置MDC和处理请求的逻辑
       chain.doFilter(request, response);
   } finally {
       MDC.remove("X_REQUEST_ID");
       // 或者批量清理：MDC.clear();
   }
   

内容的提问来源于stack exchange，提问作者dead programmer