如何解决 Logback 中 MDC.put 值未显示在日志中的问题

logback 的 mdc（mapped diagnostic context）值未出现在日志中，通常是因为配置中错误地使用了 `` 而非 `` 来解析 `%x{key}` 占位符；logback 仅在 `` 下支持 mdc 变量渲染，`` 中的 pattern 不会解析 `%x{}`。

在你的 logback.xml 中，当前使用的是 包裹 pattern：

  
    %d  [%X{ApigeeId}] [%X{BasePath}] %-5level %-50logger{40} - %message%n
  

⚠️ 关键问题：Logback 自 1.3.0 版本起（且在所有主流 1.2.x+ 版本中）， 的 不支持 MDC 变量（如 %X{key}）的动态解析——它仅处理基础日志字段（如 %d, %m, %level）。MDC 支持必须通过 显式声明。

✅ 正确写法是改用 （推荐 PatternLayout）：

  
    %d  [%X{ApigeeId}] [%X{BasePath}] %-5level %-50logger{40} - %message%n
  

? 验证提示：MDC.get("ApigeeId") 能取到值，说明 MDC 上下文设置无误（线程内有效），问题纯属日志渲染配置缺失。

? 额外注意事项：

• 确保 MDC.put() 在日志语句执行之前调用（例如在请求拦截器、AOP 前置通知或 Controller 入口处设置）；
• 若使用异步日志（如 AsyncAppender），需启用 includeCallerData="true" 或显式调用 MDC.copy() 到子线程（因 MDC 是 InheritableThreadLocal，但某些线程池可能不继承）；
• 清理旧 MDC 值：建议在请求结束时调用 MDC.clear()，避免线程复用导致脏数据（尤其在 Tomcat 等容器中）。

✅ 完整可运行示例（含清理逻辑）：

// 示例：Spring Boot 拦截器中设置 MDC
public class MdcInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        MDC.put("ApigeeId", request.getHeader("X-Apigee-Id"));
        MDC.put("BasePath", request.getServletPath());
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Obj
ect handler, Exception ex) {
        MDC.clear(); // 必须清理！
    }
}

完成配置更新后重启应用，日志将正确输出类似：

2025-01-11 13:13:09,286  [a1b2c3] [api/crm/sendemi] INFO  org.hibernate.SQL_SLOW - SlowQuery: 14 ms...

总结：MDC 不是“不工作”，而是 Logback 的 pattern 解析机制有明确上下文约束——认准 ，远离 中的 %X{}，即可一劳永逸解决空白字段问题。