Log4j2.xml怎么配置？Java日志框架XML配置模板有哪些？

Log4j2.xml配置基础概念

Log4j2是Log4j的升级版本，性能更优且配置更灵活，XML配置文件是定义其日志行为的主要方式。配置文件通常放在项目的resources目录下，框架启动时会自动扫描加载该文件。核心配置围绕Appenders（输出目标）和Loggers（日志记录器）两部分展开，前者定义日志输出到哪里，后者定义哪些类或包的日志以什么级别输出。

核心配置项说明

首先明确几个常用的配置参数含义：

• 日志级别：从低到高依次为TRACE、DEBUG、INFO、WARN、ERROR、FATAL，级别越高输出的日志越少，通常开发环境用DEBUG，生产环境用INFO或WARN。
• Appender：常见的有ConsoleAppender（控制台输出）、RollingFileAppender（滚动文件输出），后者支持按时间或文件大小自动归档旧日志。
• PatternLayout：定义日志的输出格式，比如时间、日志级别、类名、日志内容等信息的排列规则。

通用Log4j2.xml配置模板

以下是一个覆盖控制台输出和按天滚动文件输出的通用模板，可直接复制到项目中使用，根据实际需求调整路径和参数即可。

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" monitorInterval="30">
    <!-- 定义全局属性 -->
    <Properties>
        <Property name="LOG_HOME">./logs</Property>
        <Property name="FILE_NAME">app</Property>
        <!-- 日志输出格式：时间 线程 日志级别 类名 日志内容 -->
        <Property name="LOG_PATTERN">%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n</Property>
    </Properties>

    <Appenders>
        <!-- 控制台输出配置 -->
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="${LOG_PATTERN}"/>
        </Console>

        <!-- 滚动文件输出配置，按天归档 -->
        <RollingFile name="RollingFile" fileName="${LOG_HOME}/${FILE_NAME}.log"
                    filePattern="${LOG_HOME}/${FILE_NAME}-%d{yyyy-MM-dd}-%i.log">
            <PatternLayout pattern="${LOG_PATTERN}"/>
            <Policies>
                <!-- 按天滚动 -->
                <TimeBasedTriggeringPolicy interval="1"/>
                <!-- 单个文件超过100MB时滚动 -->
                <SizeBasedTriggeringPolicy size="100MB"/>
            </Policies>
            <!-- 最多保留30天的日志 -->
            <DefaultRolloverStrategy max="30"/>
        </RollingFile>
    </Appenders>

    <Loggers>
        <!-- 第三方框架日志级别调整，避免输出过多无关日志 -->
        <Logger name="org.springframework" level="INFO" additivity="false">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
        </Logger>
        <Logger name="org.apache" level="INFO" additivity="false">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
        </Logger>

        <!-- 根日志记录器配置 -->
        <Root level="INFO">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
        </Root>
    </Loggers>
</Configuration>

模板参数调整说明

如果需要根据项目需求修改配置，可以关注以下几个部分：

• 修改LOG_HOME属性可以调整日志文件的存储路径，比如改成/data/logs适配服务器环境。
• 调整Root标签的level属性可以修改全局日志级别，开发阶段可以改成DEBUG查看更详细的运行信息。
• 如果需要增加错误日志单独输出的Appender，可以新增一个RollingFile配置，过滤级别为ERROR的日志，然后在Root中引用该Appender。

验证配置是否生效

可以在项目中编写简单的测试代码验证配置是否正确：

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

public class LogTest {
    private static final Logger logger = LogManager.getLogger(LogTest.class);

    public static void main(String[] args) {
        logger.debug("这是debug级别的日志");
        logger.info("这是info级别的日志");
        logger.warn("这是warn级别的日志");
        logger.error("这是error级别的日志");
    }
}

运行上述代码后，如果控制台和日志目录下都出现了对应的日志内容，说明配置已经生效。如果只出现info及以上级别的日志，是因为当前根日志级别设置为INFO，debug级别的日志不会被输出。

Log4j2Java_logXML_config日志框架修改时间：2026-07-22 08:42:13