如何解决 Logback 中 MDC.put 值未显示在日志中的问题_网络技术

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

发布时间 - 2025-12-29 00:00:00 点击率：次

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, Object 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{}，即可一劳永逸解决空白字段问题。

# app # tomcat # logback # xml # 继承 # 线程 # copy # 异步 # 的是 # 是因为 # 出现在 # 不支持 # 而非 # 能不 # 重启 # 结束时 # 复用 # 器中

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：SQL Server 2016 无域群集配置 AlwaysO

下一篇：如何在360mb手机建站中添加自定义域名并设置DNS？

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：SQL Server 2016 无域群集配置 AlwaysO

下一篇：如何在360mb手机建站中添加自定义域名并设置DNS？