log4j2.xml配置文件详解 log4j2日志级别xml设置

Log4j2配置文件包含Configuration、Properties、Appenders和Loggers四部分，通过设置日志级别（TRACE至FATAL）控制输出，结合Console、File、RollingFile等Appender定义输出目标，支持按时间或大小滚动归档；Root Logger为默认日志器，可为特定包配置独立Logger并设置additivity防止重复输出，同时可通过monitorInterval实现配置热加载。

Log4j2 是 Java 中广泛使用的日志框架，相比 Log4j1 性能更高、功能更丰富。其配置文件 log4j2.xml 支持灵活的日志输出控制，包括日志级别、输出目标、格式等。下面详细说明 log4j2.xml 的结构与日志级别的设置方法。

1. log4j2.xml 基本结构

一个典型的 log4j2.xml 文件包含以下几个核心部分：

• Configuration：根元素，定义配置名称和日志系统行为。
• Properties：可选，用于定义变量（如日志路径、格式模板）。
• Appenders：定义日志输出目的地（控制台、文件、数据库等）。
• Loggers：定义哪些类或包使用何种日志级别和 Appender。

示例结构如下：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Properties>
        <Property name="LOG_PATTERN">%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %logger{36} - %msg%n</Property>
        <Property name="LOG_DIR" value="./logs"/>
    </Properties>
<pre class='brush:php;toolbar:false;'><Appenders>
    <Console name="Console" target="SYSTEM_OUT">
        <PatternLayout pattern="${LOG_PATTERN}"/>
    </Console>

    <File name="FileAppender" fileName="${LOG_DIR}/app.log">
        <PatternLayout pattern="${LOG_PATTERN}"/>
    </File>
</Appenders>

<Loggers>
    <Root level="info">
        <AppenderRef ref="Console"/>
        <AppenderRef ref="FileAppender"/>
    </Root>
</Loggers>

</Configuration>

2. 日志级别详解

Log4j2 支持以下从低到高的日志级别：

• TRACE：最详细的信息，用于调试追踪。
• DEBUG：调试信息，开发阶段常用。
• INFO：普通运行信息，如服务启动、关键步骤。
• WARN：潜在问题，不影响程序运行。
• ERROR：错误事件，但程序仍可继续运行。
• FATAL：严重错误，可能导致应用终止（已不推荐使用，通常用 ERROR 替代）。

设置级别后，只会输出该级别及以上级别的日志。例如：

• 级别设为 INFO，则 TRACE 和 DEBUG 不会输出。
• 级别设为 DEBUG，则 TRACE、DEBUG、INFO、WARN、ERROR 都会输出。

3. Appender 类型与配置

Appender 决定日志输出位置。常用类型有：

标贝悦读AI配音

在线文字转语音软件-专业的配音网站

20

查看详情

• Console：输出到控制台。
• File：输出到指定文件。
• RollingFile：支持滚动归档的文件输出（按大小或时间切分）。

例如，配置一个按天滚动的日志文件：

<RollingFile name="RollingFile" fileName="${LOG_DIR}/app.log"
             filePattern="${LOG_DIR}/app-%d{yyyy-MM-dd}.log.gz">
    <PatternLayout pattern="${LOG_PATTERN}"/>
    <Policies>
        <TimeBasedTriggeringPolicy/>
    </Policies>
    <DefaultRolloverStrategy max="30"/> <!-- 最多保留30个归档文件 -->
</RollingFile>

4. Logger 配置与继承机制

Logger 分为 Root Logger 和 自定义 Logger。

• Root Logger 是所有 Logger 的默认父级，必须存在。
• 可以为特定包或类配置独立的 Logger，覆盖 Root 设置。

示例：为某个包设置 DEBUG 级别，其他保持 INFO：

<Loggers>
    <Logger name="com.example.service" level="debug" additivity="false">
        <AppenderRef ref="Console"/>
    </Logger>
<pre class='brush:php;toolbar:false;'><Root level="info">
    <AppenderRef ref="Console"/>
    <AppenderRef ref="RollingFile"/>
</Root>

</Loggers>

说明：additivity="false" 表示不继承父级 Appender，避免重复输出。

5. 其他常用配置项

• status="WARN"：控制 Log4j 自身内部日志级别，用于排查配置问题。
• monitorInterval：自动重载配置的时间间隔（单位秒），便于动态调整。

<Configuration status="WARN" monitorInterval="30">

登录后复制

基本上就这些。掌握 log4j2.xml 的结构和日志级别控制，就能灵活管理应用日志输出。不复杂但容易忽略细节，比如变量引用、additivity 设置等，需结合实际场景测试验证。

以上就是log4j2.xml配置文件详解 log4j2日志级别xml设置的详细内容，更多请关注php中文网其它相关文章！