Logback.xml怎么配置？Java日志框架Logback的XML配置详解

来源：前端技术作者：南京网站建设头衔：草根站长
导读：本期聚焦于小伙伴创作的《Logback.xml怎么配置？Java日志框架Logback的XML配置详解》，敬请观看详情，探索知识的价值。以下视频、文章将为您系统阐述其核心内容与价值。如果您觉得《Logback.xml怎么配置？Java日志框架Logback的XML配置详解》有用，将其分享出去将是对创作者最好的鼓励。

Logback是Log4j的继任者，由Log4j的原作者开发，在性能和功能上都有明显提升，是Spring Boot等主流Java框架默认的日志实现。logback.xml是Logback的核心配置文件，通过XML格式定义日志的输出规则、存储方式、过滤条件等内容，合理的配置可以让日志管理更高效。

Logback.xml怎么配置？Java日志框架Logback的XML配置详解

logback.xml的基本结构

一个标准的logback.xml文件通常包含<configuration>根标签，内部可以定义属性、上下文监听器、appender、logger、root等核心组件，基本结构如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 属性定义 -->
    <property name="LOG_PATH" value="./logs"/>
    
    <!-- appender定义 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <!-- 输出格式配置 -->
    </appender>
    
    <!-- logger定义 -->
    <logger name="com.example" level="DEBUG"/>
    
    <!-- 根logger定义 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

核心配置项详解

属性定义property

通过<property>标签可以定义全局变量，后续配置中可以通过${变量名}的方式引用，避免重复编写相同的内容，比如日志存储路径、日志文件前缀等。

<!-- 定义日志存储基础路径 -->
<property name="LOG_HOME" value="./logs"/>
<!-- 定义日志文件名称前缀 -->
<property name="APP_NAME" value="my-app"/>

appender输出器配置

appender负责定义日志的输出目的地，常见的输出目的地包括控制台、文件，Logback内置了多种appender实现类，最常用的是ConsoleAppender和RollingFileAppender。

控制台输出appender

控制台输出通常用于开发环境，方便实时查看日志内容，需要配置输出格式编码器PatternLayoutEncoder：

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <!-- 日志输出格式：时间 日志级别 线程名 类名 日志内容 -->
        <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
        <charset>UTF-8</charset>
    </encoder>
</appender>

滚动文件输出appender

生产环境通常需要将日志输出到文件，并且按时间或大小滚动切割文件，避免单个日志文件过大，这时候需要使用RollingFileAppender，配合滚动策略使用：

<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <!-- 当前日志文件路径 -->
    <file>${LOG_HOME}/${APP_NAME}.log</file>
    <!-- 滚动策略：按时间滚动，每天生成一个新的日志文件 -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <!-- 滚动后的日志文件命名规则 -->
        <fileNamePattern>${LOG_HOME}/${APP_NAME}.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
        <!-- 日志文件保留天数 -->
        <maxHistory>30</maxHistory>
        <!-- 每个日志文件最大大小，超过则滚动生成新文件 -->
        <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
            <maxFileSize>100MB</maxFileSize>
        </timeBasedFileNamingAndTriggeringPolicy>
    </rollingPolicy>
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
        <charset>UTF-8</charset>
    </encoder>
</appender>

logger与root配置

<logger>用来定义特定包或类的日志级别和使用的appender，<root>是所有logger的父级，定义全局的默认日志配置。

<!-- 自定义com.example包的日志级别为DEBUG，使用FILE和CONSOLE两个appender -->
<logger name="com.example" level="DEBUG" additivity="false">
    <appender-ref ref="CONSOLE"/>
    <appender-ref ref="FILE"/>
</logger>

<!-- 根logger，默认日志级别为INFO，使用CONSOLE和FILE两个appender -->
<root level="INFO">
    <appender-ref ref="CONSOLE"/>
    <appender-ref ref="FILE"/>
</root>

其中additivity属性表示是否将日志向上级logger传递，默认是true，如果设置为false，则该logger的日志不会传递给root，避免重复输出。

日志级别过滤

如果需要更精细的日志级别过滤，可以使用LevelFilter，比如只输出ERROR级别的日志到特定文件：

<appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_HOME}/${APP_NAME}_error.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>${LOG_HOME}/${APP_NAME}_error.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
        <maxHistory>30</maxHistory>
        <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
            <maxFileSize>100MB</maxFileSize>
        </timeBasedFileNamingAndTriggeringPolicy>
    </rollingPolicy>
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
        <charset>UTF-8</charset>
    </encoder>
    <!-- 只接收ERROR级别的日志 -->
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
        <level>ERROR</level>
        <onMatch>ACCEPT</onMatch>
        <onMismatch>DENY</onMismatch>
    </filter>
</appender>

完整配置示例

以下是一个适配多数Web项目的完整logback.xml配置，包含控制台输出、普通日志文件滚动、错误日志单独存储的功能：

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="30 seconds">
    <!-- 配置扫描，修改后30秒自动加载 -->
    <property name="LOG_HOME" value="./logs"/>
    <property name="APP_NAME" value="demo-app"/>

    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!-- 普通日志文件 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_HOME}/${APP_NAME}.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_HOME}/${APP_NAME}.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxHistory>30</maxHistory>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!-- 错误日志文件 -->
    <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_HOME}/${APP_NAME}_error.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_HOME}/${APP_NAME}_error.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxHistory>30</maxHistory>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>

    <!-- 业务包日志级别 -->
    <logger name="com.example" level="DEBUG" additivity="false">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
        <appender-ref ref="ERROR_FILE"/>
    </logger>

    <!-- 根日志配置 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
        <appender-ref ref="ERROR_FILE"/>
    </root>
</configuration>

配置注意事项

  • logback.xml需要放在项目的classpath路径下，比如resources目录，Logback启动时会自动加载该文件。
  • 如果同时存在logback.xml和logback-spring.xml，Spring Boot环境下会优先加载logback-spring.xml，后者支持更多Spring相关的配置特性。
  • 日志格式中的%logger{36}表示输出类名，最长显示36个字符，超出部分会缩写，可根据需要调整数值。
  • 生产环境建议将控制台日志级别设置为INFO及以上，避免输出过多调试日志影响性能。

LogbackJavalogback_xml日志框架修改时间：2026-06-17 08:39:29

免责声明：​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰，观点力求客观中立。本站旨在免费分享，内容仅供个人学习、研究或参考使用。若引用了第三方作品，版权归原作者所有。如内容涉及您的权益，请联系我们处理。

上一篇Python处理XML解析时的编码错误有哪些方法

下一篇XML在增强现实中有哪些实际应用

猜你喜欢

内容垂直聚焦
专注技术核心技术栏目，确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计，为用户提供无干扰的纯技术知识沉淀，精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进，构建清晰学习路径，帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈，深入技术细节与实践难点。无论是数据库优化还是服务器配置，均结合真实场景与代码示例进行剖析，致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程，从数据库操作到服务器运维，形成完整闭环，一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性，步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目，显著缩短从学习到实践的距离，快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代，紧跟主流技术发展趋势，为用户提供经久不衰的学习价值。

负责任网站 - 免责声明 - 隐私政策 - 网站地图

举报邮箱：chomcom@qq.com

Copyright (C) www.ipipp.com All Rights Reserved.