日志中的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 讲解文档核心业务讲解视频从基础项目到复杂业务场景，项目资料会持续更新。
- 01Nexus Agent AI 智能体
- 02Nexus Agent Pro 完全版
- 03黑马点评Plus
- 04大麦
- 05大麦Pro
- 06大麦AI
- 07流量切换
- 08数据中台
加入后还能获得
进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。从学习、面试到项目启动，都可以继续获得支持。
- 1 对 1 解答项目和技术问题都可以提问
- 针对性补充没有讲清楚的内容会继续补充
- 面试与简历指导梳理回答技巧和项目亮点
- 中间件云环境项目依赖可以直接接入使用
- 面试后复盘被问住的问题可以继续交流
- 远程问题解决项目启动问题可协助排查
