一、依赖与默认集成机制
SpringBoot从2.x版本开始默认集成Logback日志框架,无需手动添加额外依赖。当项目引入spring-boot-starter-web
时,该组件已包含spring-boot-starter-logging
,其底层实现基于Logback+SLF4J组合。这种设计使得开发者只需关注业务日志的输出规则,无需处理日志框架的初始化工作。
验证方式可通过查看Maven依赖树:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
二、核心配置文件解析
在src/main/resources
目录下创建logback-spring.xml
文件(SpringBoot优先识别此命名格式),该文件支持多环境配置和Spring属性注入。
基础配置模板
<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="30s">
<!-- 多环境变量注入 -->
<springProperty name="LOG_DIR" source="logging.path" defaultValue="/var/logs"/>
<property name="LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"/>
<!-- 控制台彩色输出 -->
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<!-- 滚动文件策略 -->
<appender name