logback 的 mdc（mapped diagnostic context）值未出现在日志中，通常是因为配置中错误地使用了 `` 而非 `` 来解析 `%x{key}` 占位符；logback 仅在 `` 下支持 mdc 变量渲染，`` 中的 pattern 不会解析 `%x{}`。

在你的 logback.xml 中，当前使用的是 包裹 pattern：

<appender name="Console" class="ch.qos.logback.core.ConsoleAppender">
  <encoder>
    <pattern>%d  [%X{ApigeeId}] [%X{BasePath}] %-5level %-50logger{40} - %message%n</pattern>
  </encoder>
</appender>

⚠️ 关键问题：Logback 自 1.3.0 版本起（且在所有主流 1.2.x+ 版本中）， 的 不支持 MDC 变量（如 %X{key}）的动态解析——它仅处理基础日志字段（如 %d, %m, %level）。MDC 支持必须通过 显式声明。

✅ 正确写法是改用 （推荐 PatternLayout）：

<appender name="Console" class="ch.qos.logback.core.ConsoleAppender">
  <layout class="ch.qos.logback.classic.PatternLayout">
    <pattern>%d  [%X{ApigeeId}] [%X{BasePath}] %-5level %-50logger{40} - %message%n</pattern>
  </layout>
</appender>

? 验证提示：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(); // 必须清理！
    }
}

完成配置更新后重启应用，日志将正确输出类似：

2023-01-11 13:13:09,286  [a1b2c3] [api/crm/sendemi] INFO  org.hibernate.SQL_SLOW - SlowQuery: 14 ms...

总结：MDC 不是“不工作”，而是 Logback 的 pattern 解析机制有明确上下文约束——认准 ，远离 中的 %X{}，即可一劳永逸解决空白字段问题。