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

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

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

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

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

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

应用程序在线商店宣传网站模板

应用程序在线商店宣传网站模板是一款提供免费应用程序在线商店宣传网站模板下载。提示：本模板调用到谷歌字体库，可能会出现页面打开比较缓慢。

下载

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

? 关键说明：

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

? 验证建议：

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

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

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

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