如何检查JUnit测试是否正确加载log4j2-test.xml配置

在JUnit单元测试中，为修改日志行为，已在src/test/resources目录下创建log4j2-test.xml配置文件，将Root日志级别设为error，期望仅打印error级别的"Bye World"日志，但实际info级别的"Hello World"也会输出。需要验证该配置文件是否被Log4j2识别，并解决日志行为不符合预期的问题。

代码片段 #

log4j2-test.xml配置 #

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Appenders>
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %c:%L - %msg%n"/>
        </Console>
    </Appenders>
    <Loggers>
        <Root level="error" >
            <AppenderRef ref="Console"/>
        </Root>
    </Loggers>
</Configuration>

测试代码 #

@Slf4j
@Test
public void sampleTest() {
    log.info("Hello World");
    log.error("Bye World");
    assertEquals(1*5,5);
}

方法1：开启Log4j2内部调试日志 #

修改log4j2-test.xml中<Configuration>标签的status属性为DEBUG：

<Configuration status="DEBUG">

运行测试后，Log4j2会输出自身初始化过程的日志，其中会包含配置文件加载路径，例如：

Loading configuration from file:/your-project-path/target/test-classes/log4j2-test.xml

通过该日志可以确认是否加载了目标配置文件。

方法2：通过API打印当前配置信息 #

在测试方法中添加以下代码，直接输出Log4j2的当前配置详情：

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.LoggerContext;
import org.apache.logging.log4j.core.config.Configuration;

// 在sampleTest方法中添加
LoggerContext context = (LoggerContext) LogManager.getContext(false);
Configuration config = context.getConfiguration();
System.out.println("当前配置名称: " + config.getName());
System.out.println("Root日志级别: " + config.getRootLogger().getLevel());
System.out.println("配置文件来源路径: " + context.getConfigurationSource().getLocation());

运行测试后，控制台会输出这些信息，可直接确认配置是否被正确加载，以及Root级别是否设置为error。

• 配置优先级冲突：检查项目中是否存在log4j2.xml（src/main/resources下）或通过系统属性log4j.configurationFile指定了其他配置，这些会优先于log4j2-test.xml加载。
• 日志框架依赖冲突：确认项目中是否同时引入了Logback等其他日志框架，导致Log4j2未被正确使用。例如Spring Boot默认使用Logback，需排除Logback依赖并引入Log4j2 Starter。
• SLF4J绑定正确性：@Slf4j默认使用SLF4J抽象层，需确保SLF4J绑定的是Log4j2（需引入log4j-slf4j-impl依赖），而非其他日志实现。
• 局部日志级别覆盖：检查测试类或其父类是否手动设置了日志级别，覆盖了全局配置。

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