Log4j2 FATAL级别日志显示为ERROR问题求助

问题现象 #

在Spring应用中集成Log4j2后，调用logger.fatal()输出的日志级别显示为ERROR，而非预期的FATAL。测试代码及输出如下：

测试代码 #

private static final Logger logger = LogManager.getLogger(BookshelfAppServer.class);

public static void main(String[] args) {
    logger.trace("We've just greeted the user!");
    logger.debug("We've just greeted the user!");
    logger.info("We've just greeted the user!");
    logger.warn("We've just greeted the user!");
    logger.error("We've just greeted the user!");
    logger.fatal("We've just greeted the user!");
}

控制台输出 #

18:25:43.034 [main] DEBUG com.kengo.BookshelfAppServer - We've just greeted the user!
18:25:43.036 [main] INFO com.kengo.BookshelfAppServer - We've just greeted the user!
18:25:43.036 [main] WARN com.kengo.BookshelfAppServer - We've just greeted the user!
18:25:43.036 [main] ERROR com.kengo.BookshelfAppServer - We've just greeted the user!
18:25:43.036 [main] ERROR com.kengo.BookshelfAppServer - We've just greeted the user!

排查与解决步骤 #

1. 检查Logger类导入 #

确认代码中导入的Logger是Log4j2原生类：

import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.LogManager;

如果导入的是org.slf4j.Logger，由于SLF4J规范中没有FATAL级别，其fatal()方法会直接映射为ERROR级别，导致输出异常。

2. 验证Log4j2配置文件 #

• 确保日志格式中使用%level占位符，而非硬编码或错误变量：

  <!-- 正确的PatternLayout配置示例 -->
  <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %level %logger - %msg%n"/>
  

• 检查是否存在自定义级别映射或过滤规则，比如避免将FATAL级别强制转为ERROR的LevelFilter配置：

  <!-- 错误示例：需移除此类配置 -->
  <LevelFilter level="FATAL" onMatch="ACCEPT" onMismatch="DENY"/>
  

3. 清理依赖冲突 #

Spring默认使用spring-boot-starter-logging（底层为logback），需完全替换为Log4j2依赖：

<dependencies>
    <!-- 排除默认日志依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
        <exclusions>
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- 引入Log4j2依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
    </dependency>
</dependencies>

执行mvn dependency:tree查看依赖树，确保无logback、log4j1.x等冲突依赖。

4. 验证Logger实例类型 #

在代码中添加日志实例类名打印，确认使用的是Log4j2原生Logger：

System.out.println("Logger implementation: " + logger.getClass().getName());

正常输出应为org.apache.logging.log4j.core.Logger或org.apache.logging.log4j.spi.AbstractLogger。

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