Logback是由log4j创始人设计的新一代日志框架，作为SLF4J的原生实现，在性能和功能上都优于传统的log4j。logback.xml是Logback框架的配置文件，开发者可以通过这个文件自定义日志的输出规则，包括日志的输出位置、输出格式、日志级别、滚动策略等内容，不需要修改业务代码就能调整整个应用的日志行为。
logback.xml的核心作用
logback.xml的核心价值是让日志配置和业务逻辑解耦，开发者可以根据不同环境的需求灵活调整日志规则，主要作用包括以下几个方面：
- 定义日志输出位置，比如控制台、本地文件、远程日志服务等
- 设置不同包或类的日志级别，比如开发环境输出DEBUG级别，生产环境输出INFO级别
- 配置日志文件的滚动策略，避免单个日志文件过大，方便后续日志排查
- 自定义日志输出格式，比如添加时间戳、线程名、类名等信息
logback.xml的常用配置节点
一个标准的logback.xml配置文件由多个层级节点组成，下面是常用的核心节点说明：
| 节点名称 | 作用说明 |
|---|---|
| configuration | 根节点，包含所有配置内容，可设置scan、scanPeriod等属性，实现配置文件修改后自动重载 |
| appender | 定义日志输出目的地，比如控制台输出用ConsoleAppender，文件输出用RollingFileAppender |
| logger | 设置指定包或类的日志级别，可指定对应的appender |
| root | 根日志器，所有未单独配置logger的日志都会走root的规则，必须配置一个 |
| property | 定义全局变量，比如日志存储路径、日志文件名等，方便后续复用 |
基础logback.xml配置示例
下面是一个同时输出日志到控制台和本地文件的基础配置示例，包含常见的配置规则：
<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="30 seconds">
<!-- 定义日志存储路径变量 -->
<property name="LOG_PATH" value="./logs"/>
<!-- 定义日志文件名变量 -->
<property name="APP_NAME" value="demo-app"/>
<!-- 控制台输出appender -->
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<!-- 日志输出格式：时间戳 日志级别 线程名 类名 日志内容 -->
<pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
<!-- 文件输出appender，按天滚动，单个文件最大100MB -->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!-- 日志文件路径和命名规则，按天归档 -->
<fileNamePattern>${LOG_PATH}/${APP_NAME}.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
<!-- 保留最近30天的日志 -->
<maxHistory>30</maxHistory>
<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
<!-- 单个日志文件最大100MB -->
<maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
</rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
<!-- 设置com.example包下的日志级别为DEBUG -->
<logger name="com.example" level="DEBUG" additivity="false">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE"/>
</logger>
<!-- 根日志器，默认日志级别为INFO -->
<root level="INFO">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE"/>
</root>
</configuration>
不同场景的配置调整
开发环境配置
开发环境需要输出更多调试信息，可以将root的日志级别设置为DEBUG，同时可以只输出到控制台，减少文件IO开销：
<root level="DEBUG">
<appender-ref ref="CONSOLE"/>
</root>
生产环境配置
生产环境一般不需要DEBUG级别日志，避免日志量过大影响性能，同时可以配置日志异步输出，提升应用性能：
<!-- 异步输出appender -->
<appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
<!-- 队列深度，默认256 -->
<queueSize>512</queueSize>
<!-- 队列剩余容量小于这个阈值时，会丢弃TRACE、DEBUG、INFO级别的日志 -->
<discardingThreshold>0</discardingThreshold>
<appender-ref ref="FILE"/>
</appender>
<root level="INFO">
<appender-ref ref="ASYNC_FILE"/>
</root>
配置注意事项
在使用logback.xml配置日志时，需要注意以下几点：
- 配置文件的名称必须是logback.xml或者logback-spring.xml，如果是Spring Boot项目，推荐使用logback-spring.xml，支持更多Spring相关的扩展功能
- 如果同时存在logback.xml和logback-test.xml，测试环境会优先加载logback-test.xml
- 日志级别从低到高依次是TRACE、DEBUG、INFO、WARN、ERROR，设置某个级别后，会输出该级别及更高级别的日志
- additivity属性默认是true，表示当前logger的日志会传递给父logger，设置为false可以避免日志重复输出
通过合理配置logback.xml，开发者可以搭建出适配不同环境、满足不同需求的日志系统，后续排查问题时也能更高效地定位问题。如果需要在代码中输出日志，只需要使用SLF4J的API即可，不需要依赖Logback的具体实现类，比如：
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class TestService {
// 获取当前类的日志器
private static final Logger logger = LoggerFactory.getLogger(TestService.class);
public void test() {
logger.debug("这是debug级别的日志");
logger.info("这是info级别的日志");
logger.error("这是error级别的日志");
}
}
Logbacklogback.xml日志配置Java_logging修改时间：2026-07-05 06:42:30