logback 配置详解-springboot
----------------------------------------------------------------------------------------------------------
springboot logback 配置详解
在 Spring Boot 中，Logback 是默认集成的日志框架（基于 SLF4J API），相比 Log4j 等框架，它具有更高的性能和更灵活的配置。本文将详细讲解 Logback 在 Spring Boot 中的配置方式，包括核心组件、常用配置及高级特性。
一、配置文件位置与加载优先级
Spring Boot 会自动扫描类路径（
classpath）下的 Logback 配置文件，优先加载顺序如下：logback-spring.xml（推荐，支持 Spring 扩展特性，如springProfile）logback.xml（标准 Logback 配置，不支持 Spring 扩展）logback-spring.groovy/logback.groovy（Groovy 格式，较少使用）
二、核心配置组件
Logback 的配置核心由 3 个组件构成：
Logger（日志记录器）、Appender（输出目的地）、Layout（日志格式）。1. Logger（日志记录器）
Logger 负责定义 “哪些类 / 包的日志需要被处理”，并指定处理级别。
- 核心属性：
name：指定包或类的全限定名（如com.example.demo）。level：日志级别（从低到高：TRACE < DEBUG < INFO < WARN < ERROR），仅输出 “级别≥当前设置” 的日志。additivity：是否向上级 Logger（如root）传递日志（默认true，可能导致重复输出，需按需关闭）。
2. Appender（输出目的地）
Appender 定义日志的输出位置（如控制台、文件），常用实现类：
| Appender 类型 | 作用 | 适用场景 |
|---|---|---|
ConsoleAppender |
输出到控制台 | 开发环境调试 |
FileAppender |
输出到指定文件 | 简单文件记录 |
RollingFileAppender |
按规则滚动输出到多个文件（防止文件过大） | 生产环境长期日志存储 |
3. Layout（日志格式）
Layout 定义日志的输出格式，常用
PatternLayout（通过pattern属性自定义格式）。常用占位符：%d{yyyy-MM-dd HH:mm:ss.SSS}：日期时间（精确到毫秒）。%thread：当前线程名。%-5level：日志级别（左对齐，占 5 位，如INFO）。%logger{36}：Logger 名称（通常是类名，最长 36 字符，超出省略）。%msg：日志消息。%n：换行符（跨平台兼容）。
三、基础配置示例
以下是一个包含 “控制台输出 + 文件滚动输出” 的完整配置（
logback-spring.xml）：xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<!-- 1. 定义变量（方便维护） -->
<property name="LOG_PATH" value="logs/" /> <!-- 日志文件根目录 -->
<property name="LOG_NAME" value="app" /> <!-- 日志基础名称 -->
<property name="PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n" /> <!-- 日志格式 -->
<!-- 2. 控制台输出Appender -->
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<layout class="ch.qos.logback.classic.PatternLayout">
<pattern>${PATTERN}</pattern> <!-- 使用上面定义的格式 -->
</layout>
</appender>
<!-- 3. 滚动文件输出Appender（按时间+大小滚动） -->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<!-- 3.1 当前日志文件路径 -->
<file>${LOG_PATH}/${LOG_NAME}.log</file>
<!-- 3.2 滚动策略（按时间+大小分割，归档旧日志） -->
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<!-- 归档文件格式：logs/app-2023-10-29.0.log（每天一个文件夹，超过大小生成多个文件） -->
<fileNamePattern>${LOG_PATH}/%d{yyyy-MM-dd}/${LOG_NAME}.%i.log</fileNamePattern>
<maxFileSize>10MB</maxFileSize> <!-- 单个文件最大10MB -->
<maxHistory>7</maxHistory> <!-- 保留7天的归档日志 -->
<totalSizeCap>1GB</totalSizeCap> <!-- 所有日志总大小不超过1GB -->
</rollingPolicy>
<!-- 3.3 日志格式 -->
<layout class="ch.qos.logback.classic.PatternLayout">
<pattern>${PATTERN}</pattern>
</layout>
</appender>
<!-- 4. 定义Logger（指定包的日志级别） -->
<!-- 示例：com.example.demo包下的日志输出DEBUG及以上级别，且仅通过FILE输出（不传递给root） -->
<logger name="com.example.demo" level="DEBUG" additivity="false">
<appender-ref ref="FILE" />
</logger>
<!-- 5. 根Logger（默认日志处理） -->
<root