日志中的MDC到底是什么：日志上下文、链路标识、TraceId、分布式日志、上下文透传详解
日志中的MDC到底是什么
一、什么是 MDC？
MDC（Mapped Diagnostic Context） 是 log4j2 和 logback 等日志框架提供的一个功能，用于在日志中附加上下文信息。
在多线程环境下，例如 Web 应用服务器中，不同的线程可能同时处理多个用户请求，直接输出的日志往往混在一起。利用 MDC，可以在每个线程中存放一些与请求相关的信息（如用户ID、会话ID、请求追踪号等），让每条日志记录自动带上这些上下文数据，从而便于后续定位问题和追踪日志流。
二、MDC 的工作原理
MDC 的实现主要依赖于 ThreadLocal（或 InheritableThreadLocal）机制，将一个 Map 与当前线程绑定。
存储方式： 每个线程都有一份独立的 MDC 数据，开发者可以调用 MDC.put(key, value) 方法将信息写入该 Map。
数据读取： 当日志框架输出日志时，通过在日志格式中使用特殊转换符（例如 %X{key}）自动从当前线程的 MDC 中获取相应的值。
子线程传递： 默认情况下，子线程不会继承父线程的 MDC 数据；如果需要传递，则需要使用 InheritableThreadLocal 或手动传递副本（例如通过 MDC.getCopyOfContextMap() 和 MDC.setContextMap()）来实现。
这种设计确保了在多线程并发执行时，各个线程之间的 MDC 数据不会互相干扰，但也带来了一定的管理责任，必须在请求结束后及时清除数据，避免数据残留或内存泄露。
三、MDC 在日志框架中的应用
1. MDC 的设置与获取
在 Log4j2 中，我们可以使用 org.apache.log4j.MDC 类来操作 MDC。常用的方法包括：
MDC.put(String key, Object value)：将一个键值对放入当前线程的 MDC 中。
MDC.get(String key)：获取当前线程中指定 key 对应的值。
MDC.remove(String key)：移除某个键值对。
MDC.clear()：清空当前线程的所有 MDC 数据。
付费内容提示
该文档的全部内容仅对「码力全开」项目实战&技术讲解 知识星球用户开放加入星球，一次获得完整项目资料、全栈技术知识库和长期答疑服务。
100万+字全栈技术知识库深入讲解技术核心、数据库、中间件和分布式等内容8套热门的实战项目持续更新的企业级项目覆盖高并发、微服务、数据中台 和 AI Agent 等方向AI 技术知识大模型面试详解覆盖 AI 模型原理、Agent、RAG、MCP、Skills、Harness 等核心知识点文档 + 视频两种讲解形式既能系统阅读，也能跟随视频理解核心业务完整项目实战资料每套项目均包含从 0 到 1 讲解文档+核心业务讲解视频从基础项目到复杂业务场景，项目资料会持续更新。
8 套项目01Nexus Agent AI 智能体02Nexus Agent Pro 完全版03黑马点评Plus04大麦05大麦Pro06大麦AI07流量切换08数据中台加入后还能获得进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。从学习、面试到项目启动，都可以继续获得支持。
✓1 对 1 解答项目和技术问题都可以提问✓针对性补充没有讲清楚的内容会继续补充✓面试与简历指导梳理回答技巧和项目亮点✓中间件云环境项目依赖可以直接接入使用✓面试后复盘被问住的问题可以继续交流✓远程问题解决项目启动问题可协助排查扫码进入知识星球打开微信，扫描左侧二维码，加入「码力全开」项目实战&技术讲解 知识星球查看星球使用指导，获取完整项目讲解资料索引解锁全部付费内容