为何我的Log4j2配置未生效？配置文件已读取但格式失效

你的log4j2.xml配置本身语法没问题，结合你描述的现象，大概率是以下几个原因之一：

1. 依赖冲突导致日志实现被覆盖 #

检查项目依赖，是否同时存在log4j 1.x和log4j 2.x的依赖，或者SLF4J绑定到了错误的日志实现（比如slf4j-log4j12）。这类冲突会让log4j2的配置被忽略，转而使用旧版或其他日志框架的默认格式：

• 用Maven的mvn dependency:tree或Gradle的./gradlew dependencies命令查看依赖树，找出冲突的依赖并排除。
• 确保SLF4J绑定的是log4j2的适配包：log4j-slf4j-impl，而非其他绑定。

2. 配置文件被其他优先级更高的配置覆盖 #

虽然语法错误时程序报错，但可能存在多个log4j2配置文件，程序加载了其他位置的文件（比如jar包内置的配置）：

• 启动时通过-Dlog4j2.configurationFile=file:/绝对路径/log4j2.xml强制指定你的配置文件路径，验证是否生效。

3. 代码中使用了错误的日志API #

如果你的代码里用的是log4j 1.x的API（org.apache.log4j.Logger），且未引入log4j2的适配包log4j-1.2-api，那么log4j2的配置不会对这些日志输出生效，会使用log4j1的默认格式：

• 检查代码中的Logger导入包，改为log4j2的API：org.apache.logging.log4j.Logger，并通过LogManager.getLogger()获取Logger实例。
• 若必须保留log4j1的API，添加log4j-1.2-api依赖，让log4j2接管旧API的日志输出。

4. 确认配置是否真的被应用 #

给配置文件的Configuration节点添加status="DEBUG"，启动时会输出更详细的log4j2初始化日志，确认你的stderr appender和PatternLayout是否被正确加载：

<?xml version="1.0"?>
<Configuration status="DEBUG">
    <Appenders>
        <Console name="stderr" target="SYSTEM_ERR">
            <PatternLayout pattern="Meow %d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
        </Console>
    </Appenders>
    <Loggers>
        <Root level="INFO">
            <AppenderRef ref="stderr"/>
        </Root>
    </Loggers>
</Configuration>

启动后查看StatusLogger的输出，确认是否有类似Added appender [stderr] to Logger [root]的日志，以及PatternLayout的配置是否被正确解析。

内容的提问来源于stack exchange，提问作者Mikhail T.