logback 的 mdc（mapped diagnostic context）需通过 `
在 Logback 中，MDC.put("key", "value") 确实能成功将键值对存入当前线程上下文（可通过 MDC.get("key") 验证），但能否在日志中显示，取决于日志输出配置是否支持 MDC 变量解析。
关键误区在于：许多开发者误以为
✅ 正确配置方式（推荐）：
%d [%X{ApigeeId:-N/A}] [%X{BasePath:-N/A}] %-5level %-50logger{40} - %message%n
⚠️ 注意事项：
必须指定 class="ch.qos.logback.classic.PatternLayout"（经典版布局，专为 Logger 设计）； - 使用 %-X{key:-default} 可设置默认值（如 :-N/A），避免空字段影响日志可读性；
- MDC 是线程绑定的，务必在请求入口（如 Spring 拦截器、Servlet Filter 或 WebMvcConfigurer）中 put，并在请求结束时调用 MDC.clear() 或 MDC.remove("key")，防止线程复用导致脏数据（尤其在 Tomcat 线程池场景下）；
- 若使用异步日志（如 AsyncAppender），需确保 includeCallerData="false" 且 discardingThreshold="0" 配合 MDC.put()，或改用 AsyncAppender + MDCFilter 等方案保障上下文传递。
总结：MDC 值未出现在日志中，99% 是因配置层级错误。请立即检查 logback.xml 中是否将 %X{...} 写在
