Logback MDC 值未显示在日志中的原因与解决方案

碧海醫心

发布时间：2025-12-29 16:35:11

761人浏览过

来源于php中文网

原创

Logback MDC 值未显示在日志中的原因与解决方案

logback 中 `mdc.put()` 设置的值未出现在日志中，通常是因配置使用了 `` 而非 ``，导致 `%x{key}` 占位符无法被正确解析；需改用 `` 包裹 `` 并确保 appender 类型支持 mdc。

在 Logback 中，MDC（Mapped Diagnostic Context）用于向日志中动态注入上下文信息（如请求 ID、路径等），但其值能否成功渲染到日志中，高度依赖 appender 的配置方式。

你当前的 logback.xml 使用了标签：


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

⚠️ 问题根源：仅负责字节流编码（如字符集、压缩），不处理 MDC 变量解析；它会原样输出 %X{...} 字符串（或留空），而不会从 MDC Map 中取值替换。这也是为什么 MDC.get("ApigeeId") 在代码中能正常返回，但日志里显示为空 []。

✅ 正确做法：改用（推荐 PatternLayout），它是专为格式化和变量解析设计的组件：

AI Kiss | Free AI Kissing Video Generator

免费接吻视频生成器

下载


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

? 关键说明：

class="ch.qos.logback.classic.PatternLayout" 必须显式声明（尤其在较新 Logback 版本中，否则可能默认使用无 MDC 支持的简易 layout）；
%-X{key:-default} 支持默认值语法（如 :-N/A），避免 key 不存在时输出空括号；
确保 MDC.put() 调用发生在日志语句之前，且处于同一线程（MDC 是基于 ThreadLocal 实现的，异步线程/线程池需手动传递）。

? 验证建议：

添加测试日志确认 MDC 生效：

MDC.put("ApigeeId", "api-123");
MDC.put("BasePath", "/api/crm/sendemi");
logger.info("MDC test log entry"); // 应输出填充后的值

日志中若仍为空，请检查是否在过滤器、AOP 或异步调用（如 CompletableFuture、@Async）中丢失 MDC 上下文——此时需使用 MDC.getCopyOfContextMap() + 手动传递 + MDC.setContextMap() 恢复。

? 总结：Logback 的 MDC 渲染能力由 PatternLayout 提供，而非 Encoder；务必使用替代配置 pattern，并显式指定 PatternLayout 类。这是解决 MDC 值“写入成功但日志不显示”问题的最常见且关键步骤。

Java泛型类型擦除下如何正确获取参数化类型的Class对象

如何在 Eclipse 中正确引入并使用外部 .class 文件

ArchUnit 实战：强制要求每个业务类都具备对应测试类

Java 怎么读取 Excel？最简单的 POI 示例

Java泛型类型擦除下如何获取Class实例以匹配泛型方法参数

相关标签:

编码 app 字节为什么 logback xml 字符串 class 线程 map default 异步

本站声明：本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系admin@php.cn

上一篇：JPQL 查询中使用实体构造函数的正确写法下一篇：StreamTokenizer 控制台输入的 EOF 终止问题详解

作者最新文章

Laravel Sail 数据库驱动错误解决方案（Mac M1/M2 环境）

2025-12-27 21:21

JAX梯度计算中链式布尔表达式的正确写法

2025-12-27 22:13

如何在 Vaadin 23 中监听页面后退操作并弹出确认对话框

2025-12-27 22:21

如何在 Pipfile 中正确引用本地 Git 仓库的指定分支

2025-12-27 22:46

如何在 Go 中正确使用 exec.Command 调用 awk 命令

2025-12-27 22:52

如何在 Go 中实现 SoundCloud 音频流播放

2025-12-27 23:01

如何在 Vaadin 23 中拦截浏览器后退按钮并显示确认对话框

2025-12-27 23:04

如何在 Pipfile 中正确引用本地 Git 仓库的特定分支

2025-12-27 23:05

如何仅用纯 CSS 实现 HTML 多语言切换（无需 JavaScript）

2025-12-27 23:31

如何通过点击将列表项移至顶部

2025-12-27 23:52

热门AI工具

DeepSeek

幻方量化公司旗下的开源大模型平台

AI大模型

开放平台

豆包大模型

字节跳动自主研发的一系列大型语言模型

AI大模型

通义千问

阿里巴巴推出的全能AI助手

AI大模型

腾讯元宝

腾讯混元平台推出的AI助手

文档处理

Excel 表格

文心一言

文心一言是百度开发的AI聊天机器人，通过对话可以生成各种形式的内容。

AI大模型

中文写作

讯飞写作

基于讯飞星火大模型的AI写作工具，可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

中文写作

写作工具

即梦AI

一站式AI创作平台，免费AI图片和视频生成。

图片拼接

图画生成

ChatGPT

最最强大的AI聊天机器人程序，ChatGPT不单是聊天机器人，还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

AI大模型

中文写作

智谱清言 - 免费全能的AI助手

AI大模型

PDF 文档

相关专题

pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法：1. 使用在线转换器；2. 使用桌面软件（如 adobe acrobat、itext）；3. 使用命令行工具（如 pdftoxml）。本专题为大家提供相关的文章、下载、课程内容，供大家免费下载体验。

1846

2024.04.01

xml怎么变成word

步骤：1. 导入 xml 文件；2. 选择 xml 结构；3. 映射 xml 元素到 word 元素；4. 生成 word 文档。提示：确保 xml 文件结构良好，并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容，可以阅读本专题下面的文章。

2080

2024.08.01

xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言，标准通用标记语言的子集，是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容，可阅读本专题下面的相关文章。

917

2024.11.28

js 字符串转数组

js字符串转数组的方法：1、使用“split()”方法；2、使用“Array.from()”方法；3、使用for循环遍历；4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容，供大家免费下载体验。

246

2023.08.03

js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容，供大家免费下载体验。

204

2023.09.04

java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友，请阅读本专题下面的的有关文章，欢迎大家来php中文网学习。

1431

2023.10.24

字符串介绍

字符串是一种数据类型，它可以是任何文本，包括字母、数字、符号等。字符串可以由不同的字符组成，例如空格、标点符号、数字等。在编程中，字符串通常用引号括起来，如单引号、双引号或反引号。想了解更多字符串的相关内容，可以阅读本专题下面的文章。

606

2023.11.24

java读取文件转成字符串的方法

Java8引入了新的文件I/O API，使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java，可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中，你需要将文件路径替换为你的实际文件路径，并且可能需要处理可能的IOException异常。想了解更多java的相关内容，可以阅读本专题下面的文章。

546

2024.03.22