Log4j配置requestId：控制台显示正常但日志文件不输出问题排查

我之前也碰到过一模一样的问题！控制台能输出requestId但日志文件里看不到，大概率是你没给日志文件的输出格式配置上requestId占位符，或者自定义的Log4j配置覆盖了application.properties的设置。具体可以从这几个方向排查：

1. 检查日志文件的专属格式配置 #

你在application.properties里设置的logging.pattern.level=%X{requestId}%5p，其实是给日志级别前缀加上requestId，但这个配置默认可能只对控制台生效。如果要让日志文件也输出requestId，你需要单独指定文件的完整输出pattern：

# 控制台格式（可保留原配置）
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %X{requestId}%5p %logger{36} - %msg%n
# 日志文件格式，必须包含%X{requestId}
logging.pattern.file=%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %X{requestId}%5p %logger{36} - %msg%n

配置后重启项目，日志文件里应该就能看到requestId了。

2. 排查是否存在自定义Log4j配置文件 #

如果你的项目里有log4j2.xml或log4j2-spring.xml这类自定义配置文件，那application.properties里的日志配置会被优先级更高的XML配置覆盖。这时候你需要在XML的文件Appender的PatternLayout里手动添加%X{requestId}：

<Appender name="FileAppender" type="File">
    <FileName>logs/your-app.log</FileName>
    <Layout type="PatternLayout">
        <!-- 务必在格式中加入%X{requestId} -->
        <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %X{requestId}%5p %c{1.} - %msg%n</Pattern>
    </Layout>
</Appender>

3. 确认过滤器的执行细节（可选排查） #

既然控制台能输出requestId，说明MDC的设置逻辑是有效的，但可以顺便做两个小检查：

• 过滤器的url-pattern是否设为/*，确保覆盖所有请求路径；
• 在请求结束后记得清理MDC，避免内存泄漏，用try-finally块包裹：

@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
    try {
        MDC.put("requestId", UUID.randomUUID().toString());
        chain.doFilter(request, response);
    } finally {
        MDC.remove("requestId");
    }
}

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