问题：RollingFileAppender无法读取ThreadContext映射项设置文件名

我来帮你排查这个问题——核心原因大概率是Log4j2配置里的ThreadContext变量引用语法不对，或者如果是多线程/多请求场景下，直接用RollingFileAppender本身就不支持动态切换文件名。下面分情况给你解决方案：

一、先检查最基础的配置语法问题 #

在Log4j2中，要引用ThreadContext里的变量，必须使用${ctx:变量名}的格式（也可以用${sd:变量名}，效果一致）。如果你之前的配置里直接写了${identifier}或者其他格式，肯定读不到值。

给你一个能正常工作的RollingFileAppender配置示例（适合全局唯一identifier的场景，比如启动时就固定这个值）：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" name="MyApp" packages="">
  <Appenders>
    <!-- 文件名里用${ctx:identifier}引用ThreadContext的值 -->
    <RollingFile name="RollingFile" fileName="logs/app-${ctx:identifier}.log"
                 filePattern="logs/app-${ctx:identifier}-%d{MM-dd-yyyy}-%i.log.gz">
      <PatternLayout>
        <Pattern>%d %p %c{1.} [%t] %m%n</Pattern>
      </PatternLayout>
      <Policies>
        <TimeBasedTriggeringPolicy/>
        <SizeBasedTriggeringPolicy size="10 MB"/>
      </Policies>
    </RollingFile>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="RollingFile"/>
    </Root>
  </Loggers>
</Configuration>

这种场景下，只要你在日志第一次生成前设置好ThreadContext（你的代码里已经做到了，先put再log），文件名就会正确带上threadcontext value这个后缀。

二、如果是多线程/多请求需要动态生成不同日志文件 #

如果你的应用里不同线程或者请求有不同的identifier值，直接用RollingFileAppender是不行的——因为它是单实例的，初始化后文件名就固定了。这时候必须用RoutingAppender来根据ThreadContext的值动态路由到对应的日志文件。

给你一个适配动态场景的配置：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
  <Appenders>
    <Routing name="Routing">
      <!-- 用$${ctx:identifier}作为路由规则，第一个$是转义，确保每次日志事件都会重新解析ThreadContext -->
      <Routes pattern="$${ctx:identifier}">
        <!-- 当存在identifier时，自动创建对应的RollingFileAppender实例 -->
        <Route>
          <RollingFile name="RollingFile-${ctx:identifier}" 
                       fileName="logs/app-${ctx:identifier}.log"
                       filePattern="logs/app-${ctx:identifier}-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout pattern="%d %p %c{1.} [%t] %m%n"/>
            <Policies>
              <TimeBasedTriggeringPolicy/>
              <SizeBasedTriggeringPolicy size="10 MB"/>
            </Policies>
          </RollingFile>
        </Route>
        <!-- 当identifier不存在时，路由到默认的日志文件 -->
        <Route key="$${ctx:identifier}" ref="DefaultRollingFile"/>
      </Routes>
      <!-- 默认Appender配置 -->
      <RollingFile name="DefaultRollingFile" fileName="logs/app-default.log"
                   filePattern="logs/app-default-%d{MM-dd-yyyy}-%i.log.gz">
        <PatternLayout pattern="%d %p %c{1.} [%t] %m%n"/>
        <Policies>
          <TimeBasedTriggeringPolicy/>
          <SizeBasedTriggeringPolicy size="10 MB"/>
        </Policies>
      </RollingFile>
    </Routing>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="Routing"/>
    </Root>
  </Loggers>
</Configuration>

三、额外注意事项 #

• 如果你用的是线程池，一定要记得在任务结束后清理ThreadContext，避免变量污染：

  try {
    ThreadContext.put("identifier", "threadcontext value");
    logger.info("sjdoe");
  } finally {
    ThreadContext.remove("identifier"); // 或者用ThreadContext.clear()清空所有项
  }
  

• 确认你用的是Log4j 2.x版本，ThreadContext是Log4j2的API，和Log4j1.x的MDC语法不一样，别搞混了。

内容的提问来源于stack exchange，提问作者Neha Ranjan