Spring Boot集成Logback终极指南：从基础到高级配置

于 2025-05-07 09:00:00 发布
阅读量1.2k 收藏 25
点赞数 37
分类专栏： # 基础入门 文章标签： spring boot logback
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_27756951/article/details/147729130
版权

一、Logback简介与Spring Boot集成基础

1.1 Logback是什么？

Logback是一个可靠、通用且快速的Java日志框架，作为Log4j的继承者，由Log4j创始人设计。它由三个模块组成：

  • logback-core：基础模块
  • logback-classic：实现了SLF4J API
  • logback-access：与Servlet容器集成提供HTTP访问日志功能

为什么选择Logback？

  • 性能比Log4j更高
  • 丰富的文档
  • 自动重新加载配置文件
  • 自动压缩日志文件
  • 更灵活的过滤功能
  • 更丰富的日志格式

1.2 Spring Boot默认日志框架

Spring Boot默认使用Logback作为日志框架，当你使用spring-boot-starter或spring-boot-starter-web时，已经自动引入了Logback依赖。

<!-- 在Spring Boot项目中，你不需要显式添加Logback依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
</dependency>

1.3 基本日志使用示例

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@RestController
public class DemoController {
    // 获取Logger实例，通常以当前类作为参数
    private static final Logger logger = LoggerFactory.getLogger(DemoController.class);
    
    @GetMapping("/demo")
    public String demo() {
        logger.trace("This is a TRACE level message");
        logger.debug("This is a DEBUG level message");
        logger.info("This is an INFO level message");
        logger.warn("This is a WARN level message");
        logger.error("This is an ERROR level message");
        
        return "Check your console or log file!";
    }
}

二、Logback配置文件详解

2.1 配置文件加载顺序

Spring Boot会按以下顺序查找Logback配置文件：

  1. logback-spring.xml (推荐使用)
  2. logback.xml
  3. 如果以上都不存在，使用默认配置

为什么推荐使用logback-spring.xml？

  • 可以使用Spring Boot特有的<springProperty>标签
  • 支持Spring Profile特定的配置

2.2 配置文件基本结构

一个完整的Logback配置文件通常包含以下部分：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 属性定义 -->
    <property name="LOG_HOME" value="./logs" />
    
    <!-- 定义appender -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <!-- encoder定义日志输出格式 -->
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <!-- 定义logger -->
    <logger name="com.example.demo" level="DEBUG" />
    
    <!-- 根logger配置 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
    </root>
</configuration>

三、核心组件深度解析

3.1 <configuration> 元素

<configuration>是Logback配置文件的根元素，支持以下重要属性：

属性名类型默认值描述
scanbooleanfalse是否监视配置文件变化
scanPeriod时间间隔1分钟检查配置文件变化的时间间隔
debugbooleanfalse是否打印Logback内部调试信息
packagingDatabooleanfalse是否包含调用者信息（影响性能）

示例：

<configuration scan="true" scanPeriod="30 seconds" debug="false">
    <!-- 配置内容 -->
</configuration>

最佳实践：

  • 开发环境可以开启scan以便动态调整配置
  • 生产环境应关闭scan和debug以避免性能开销
  • 仅在需要诊断问题时开启packagingData

3.2 <property> 元素

用于定义变量，可在配置文件中重复使用：

属性：

  • name: 变量名（必填）
  • value: 变量值
  • file: 从外部文件加载属性
  • resource: 从classpath资源加载属性
  • scope: 作用域（“local"或"context”）

示例：

<!-- 直接定义 -->
<property name="LOG_HOME" value="/var/logs/myapp" />

<!-- 从系统环境变量获取 -->
<property name="LOG_HOME" value="${LOG_DIR:-./logs}" />

<!-- 从外部文件加载 -->
<property file="conf/logback.properties" />

<!-- 在Spring Boot中使用 -->
<springProperty scope="context" name="appName" source="spring.application.name" />

变量引用方式： ${变量名}

作用域说明：

  • local: 仅在当前配置文件中有效
  • context: 在整个LoggerContext中有效

3.3 <timestamp> 元素

用于定义时间戳变量：

属性：

  • key: 变量名
  • datePattern: 日期格式（遵循Java SimpleDateFormat）
  • timeReference: 时间参考点（"contextBirth"或当前时间）

示例：

<timestamp key="bySecond" datePattern="yyyyMMdd'T'HHmmss" />
<property name="LOG_FILE" value="${LOG_HOME}/log-${bySecond}.log" />

3.4 <appender> 元素

Appender负责定义日志输出目的地，是Logback最核心的组件之一。

3.4.1 Appender通用结构
<appender name="UNIQUE_NAME" class="APPENDER_CLASS">
    <!-- 过滤器配置 -->
    <filter class="ch.qos.logback.core.filter.FilterClass" />
    
    <!-- 布局/编码器配置 -->
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss} %msg%n</pattern>
    </encoder>
    
    <!-- 其他特有配置 -->
</appender>
3.4.2 ConsoleAppender

输出日志到控制台（System.out或System.err）

特有属性：

  • target: 输出目标（“System.out"或"System.err”），默认为System.out
  • withJansi: 是否启用ANSI颜色支持（需jansi库）

示例：

<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <target>System.out</target>
    <encoder>
        <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>
3.4.3 FileAppender

输出日志到单个文件

特有属性：

  • file: 日志文件路径
  • append: 是否追加到文件末尾（默认为true）
  • prudent: 是否安全模式（多进程写入同一文件时使用）

示例：

<appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <file>${LOG_HOME}/myapp.log</file>
    <append>true</append>
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>
3.4.4 RollingFileAppender

支持日志文件滚动的增强FileAppender，必须配置rollingPolicy

特有属性：

  • file: 当前活动日志文件路径
  • rollingPolicy: 滚动策略配置
  • triggeringPolicy: 触发策略配置

示例：

<appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_HOME}/myapp.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>${LOG_HOME}/myapp.%d{yyyy-MM-dd}.log</fileNamePattern>
        <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>
3.4.5 滚动策略详解

Logback提供多种滚动策略：

TimeBasedRollingPolicy
基于时间的滚动策略

属性说明
fileNamePattern滚动文件命名模式（必须包含%d）
maxHistory保留的历史日志文件最大数量
totalSizeCap所有日志文件总大小限制
cleanHistoryOnStart启动时是否清理历史文件（默认false）

SizeAndTimeBasedRollingPolicy
结合时间和大小的滚动策略

属性说明
fileNamePattern必须包含%d和%i
maxFileSize单个文件最大大小
maxHistory保留的历史日志文件最大数量
totalSizeCap所有日志文件总大小限制

FixedWindowRollingPolicy
固定窗口滚动策略

属性说明
minIndex窗口最小索引
maxIndex窗口最大索引
fileNamePattern必须包含%i
3.4.6 其他Appender类型
Appender类型类名用途
SMTPAppenderch.qos.logback.classic.net.SMTPAppender通过邮件发送错误日志
DBAppenderch.qos.logback.classic.db.DBAppender存储日志到数据库
SocketAppenderch.qos.logback.classic.net.SocketAppender通过网络socket发送日志
SyslogAppenderch.qos.logback.classic.net.SyslogAppender发送日志到syslog服务器

3.5 <encoder> 元素

Encoder负责将日志事件转换为字节数组并写入输出流。

3.5.1 PatternLayoutEncoder

最常用的Encoder实现，支持丰富的模式表达式：

<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
    <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
    <outputPatternAsHeader>false</outputPatternAsHeader>
    <charset>UTF-8</charset>
</encoder>

常用转换符：

转换符说明
%d日期时间
%thread线程名
%level日志级别
%loggerLogger名称
%msg日志消息
%n换行符
%caller调用者信息
%mdcMDC内容
%ex异常堆栈
%marker日志标记

日期格式：
%d{格式}，格式遵循Java SimpleDateFormat：

  • %d{yyyy-MM-dd HH:mm:ss.SSS}
  • %d{ISO8601}
  • %d{ABSOLUTE}

Logger名称缩写：
%logger{长度}，如%logger{36}表示最长显示36个字符

3.5.2 LayoutWrappingEncoder

包装其他Layout实现的Encoder：

<encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
    <layout class="ch.qos.logback.classic.PatternLayout">
        <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </layout>
</encoder>

3.6 <filter> 元素

Filter用于对日志事件进行过滤，可以配置在Appender或Logger上。

3.6.1 LevelFilter

精确匹配特定级别：

<filter class="ch.qos.logback.classic.filter.LevelFilter">
    <level>ERROR</level>
    <onMatch>ACCEPT</onMatch>  <!-- 匹配时的动作 -->
    <onMismatch>DENY</onMismatch>  <!-- 不匹配时的动作 -->
</filter>

动作类型：

  • ACCEPT: 接受日志事件
  • DENY: 拒绝日志事件
  • NEUTRAL: 中立，由后续过滤器决定
3.6.2 ThresholdFilter

阈值过滤，接受>=指定级别的日志：

<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
    <level>WARN</level>
</filter>
3.6.3 EvaluatorFilter

使用Groovy表达式过滤：

<filter class="ch.qos.logback.core.filter.EvaluatorFilter">
    <evaluator class="ch.qos.logback.classic.boolex.GEventEvaluator">
        <expression>
            e.level.toInt() >= WARN.toInt() && 
            e.getMessage().contains("important")
        </expression>
    </evaluator>
    <onMatch>ACCEPT</onMatch>
    <onMismatch>DENY</onMismatch>
</filter>
3.6.4 自定义Filter

实现ch.qos.logback.core.filter.Filter接口：

public class SampleFilter extends Filter<ILoggingEvent> {
    @Override
    public FilterReply decide(ILoggingEvent event) {
        if (event.getMessage().contains("special")) {
            return FilterReply.ACCEPT;
        }
        return FilterReply.NEUTRAL;
    }
}

配置：

<filter class="com.example.SampleFilter" />

3.7 <logger> 和 <root> 元素

3.7.1 <logger>

配置特定Logger的日志行为：

属性：

  • name: Logger名称（通常为包或类名）
  • level: 日志级别
  • additivity: 是否向上传递日志（默认为true）

示例：

<!-- 配置特定包的日志级别 -->
<logger name="com.example" level="DEBUG" />

<!-- 配置特定类的日志级别并禁用additivity -->
<logger name="com.example.Service" level="TRACE" additivity="false">
    <appender-ref ref="SPECIAL_APPENDER" />
</logger>
3.7.2 <root>

配置根Logger，所有Logger最终都继承自Root Logger：

属性：

  • level: 根Logger的日志级别

示例：

<root level="INFO">
    <appender-ref ref="CONSOLE" />
    <appender-ref ref="FILE" />
</root>

Logger继承规则：

  1. 如果没有配置特定logger，则继承最近的祖先logger的级别
  2. 如果没有配置任何logger，则使用root logger的级别
  3. 如果配置了logger但没有指定级别，则继承最近的祖先logger的级别

3.8 <turboFilter> 元素

TurboFilter是全局过滤器，在所有Logger之前执行：

<turboFilter class="ch.qos.logback.classic.turbo.MarkerFilter">
    <Marker>important</Marker>
    <OnMatch>ACCEPT</OnMatch>
    <OnMismatch>NEUTRAL</OnMismatch>
</turboFilter>

常用TurboFilter：

  • MDCFilter: 基于MDC值过滤
  • DynamicThresholdFilter: 动态阈值过滤
  • LoggerFilter: 基于Logger名称过滤

四、高级配置与使用技巧

4.1 日志级别详解

Logback支持以下日志级别（从低到高）：

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR

日志级别继承规则：

  1. 如果没有配置特定logger，则继承最近的祖先logger的级别
  2. 如果没有配置任何logger，则使用root logger的级别

4.2 使用Spring Boot属性

在logback-spring.xml中可以使用Spring Boot的属性：

<springProperty scope="context" name="appName" source="spring.application.name" defaultValue="myApp"/>
<property name="LOG_HOME" value="./logs/${appName}" />

4.3 基于Profile的配置

可以为不同的Spring Profile配置不同的日志策略：

<springProfile name="dev">
    <logger name="com.example.demo" level="DEBUG" />
</springProfile>

<springProfile name="prod">
    <logger name="com.example.demo" level="INFO" />
    <root level="WARN">
        <appender-ref ref="FILE" />
    </root>
</springProfile>

4.4 日志文件滚动策略

TimeBasedRollingPolicy: 基于时间的滚动策略

<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    <fileNamePattern>${LOG_HOME}/application.%d{yyyy-MM-dd}.log</fileNamePattern>
    <maxHistory>30</maxHistory>
</rollingPolicy>

SizeAndTimeBasedRollingPolicy: 基于时间和大小的滚动策略

<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
    <fileNamePattern>${LOG_HOME}/application.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
    <maxFileSize>10MB</maxFileSize>
    <maxHistory>30</maxHistory>
    <totalSizeCap>1GB</totalSizeCap>
</rollingPolicy>

4.5 日志过滤

LevelFilter: 按级别过滤

<appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
        <level>ERROR</level>
        <onMatch>ACCEPT</onMatch>
        <onMismatch>DENY</onMismatch>
    </filter>
    <!-- 其他配置 -->
</appender>

ThresholdFilter: 阈值过滤

<appender name="WARN_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>WARN</level>
    </filter>
    <!-- 其他配置 -->
</appender>

4.6 异步日志

使用AsyncAppender可以提高日志性能：

<appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
    <queueSize>512</queueSize>
    <discardingThreshold>0</discardingThreshold>
    <includeCallerData>false</includeCallerData>
    <appender-ref ref="FILE" />
</appender>

参数说明：

  • queueSize: 队列大小（默认256）
  • discardingThreshold: 当队列剩余容量小于此值时，丢弃TRACE、DEBUG和INFO级别的日志（默认队列大小的20%）
  • includeCallerData: 是否包含调用者数据（影响性能）

最佳实践：

  • 生产环境推荐队列大小设置为512-2048
  • 除非必要，否则关闭includeCallerData
  • 对于关键日志，设置discardingThreshold=0确保不丢弃

4.7 MDC (Mapped Diagnostic Context)

MDC可以用于在日志中添加上下文信息：

import org.slf4j.MDC;

public class UserService {
    private static final Logger logger = LoggerFactory.getLogger(UserService.class);
    
    public void login(String userId) {
        MDC.put("userId", userId);
        logger.info("User logged in");
        MDC.remove("userId");
    }
}

在配置文件中使用：

<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{userId}] %-5level %logger{36} - %msg%n</pattern>

高级用法：

<!-- 仅当MDC中存在userId时才显示 -->
<pattern>%d{yyyy-MM-dd} [%thread] %mdc{userId:-} %-5level %logger{36} - %msg%n</pattern>

4.8 条件配置

使用<if>条件语句（需要Janino库）：

<if condition='property("env").equals("prod")'>
    <then>
        <root level="WARN">
            <appender-ref ref="FILE" />
        </root>
    </then>
    <else>
        <root level="DEBUG">
            <appender-ref ref="CONSOLE" />
        </root>
    </else>
</if>

五、最佳实践与常见问题

5.1 日志最佳实践

  1. 合理使用日志级别：

    • TRACE: 非常详细的系统运行信息，通常只在开发时使用
    • DEBUG: 调试信息，有助于诊断问题
    • INFO: 重要的业务处理信息
    • WARN: 潜在的问题，但系统还能正常工作
    • ERROR: 错误事件，但系统还能继续运行

  2. 日志内容规范：

    • 记录有意义的业务信息
    • 避免记录敏感信息（密码、信用卡号等）
    • 异常应该记录堆栈（使用logger.error(“message”, e)）

  3. 性能考虑：

    • 生产环境避免使用DEBUG级别
    • 谨慎使用调用者数据（%C, %M, %F, %L等）
    • 考虑使用异步日志

5.2 常见问题解决方案

问题1：日志文件不滚动

  • 检查fileNamePattern中的日期模式
  • 确保日志量达到滚动条件
  • 检查文件权限

解决方案：

<!-- 确保配置了触发策略 -->
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
    <fileNamePattern>logs/app-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
    <maxFileSize>50MB</maxFileSize>  <!-- 必须配置 -->
    <maxHistory>30</maxHistory>
</rollingPolicy>

问题2：日志文件太大

  • 调整maxFileSize和maxHistory
  • 使用totalSizeCap限制总大小
  • 考虑按级别分离日志文件

问题3：日志输出不全

  • 检查logger的级别设置
  • 检查是否有过滤器过滤掉了日志
  • 检查是否有多个配置文件的冲突

问题4：日志输出乱码

解决方案：

<encoder>
    <pattern>%msg%n</pattern>
    <charset>UTF-8</charset>  <!-- 明确指定字符集 -->
</encoder>

六、完整配置示例

5.1 开发环境配置 (logback-spring-dev.xml)

<?xml version="1.0" encoding="UTF-8"?>
<!-- Logback配置文件的根标签，所有配置元素都需包含在此标签内 -->
<configuration>
    <!-- 属性定义部分，通过 <property> 标签定义可复用的属性，方便在配置文件中引用 -->
    <!-- 定义日志文件存储的主目录 -->
    <property name="LOG_HOME" value="/var/logs/myapp" />
    <!-- 定义日志输出的格式模式，包含日期时间、线程名、日志级别、日志记录器名称和日志消息 -->
    <property name="LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n" />

    <!-- 控制台Appender配置，用于将日志输出到控制台 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <!-- 编码器配置，将日志事件转换为指定格式的字符串 -->
        <encoder>
            <!-- 使用前面定义的日志格式模式 -->
            <pattern>${LOG_PATTERN}</pattern>
        </encoder>
        <!-- 过滤器配置，只允许指定级别及以上的日志通过 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <!-- 设置过滤级别为 WARN，即只输出 WARN 及以上级别的日志 -->
            <level>WARN</level>
        </filter>
    </appender>

    <!-- 主文件Appender配置，用于将日志输出到文件，并支持滚动策略 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 指定日志文件的路径，使用前面定义的日志主目录 -->
        <file>${LOG_HOME}/application.log</file>
        <!-- 编码器配置，将日志事件转换为指定格式的字符串 -->
        <encoder>
            <!-- 使用前面定义的日志格式模式 -->
            <pattern>${LOG_PATTERN}</pattern>
        </encoder>
        <!-- 滚动策略配置，基于文件大小和时间进行滚动 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!-- 滚动后的文件命名模式，包含日期和序号 -->
            <fileNamePattern>${LOG_HOME}/application.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <!-- 单个日志文件的最大大小，超过此大小将进行滚动 -->
            <maxFileSize>50MB</maxFileSize>
            <!-- 保留的历史日志文件的最大天数 -->
            <maxHistory>30</maxHistory>
            <!-- 所有日志文件的总大小上限 -->
            <totalSizeCap>5GB</totalSizeCap>
        </rollingPolicy>
    </appender>

    <!-- 错误日志Appender配置，专门用于记录 ERROR 级别的日志 -->
    <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 指定错误日志文件的路径，使用前面定义的日志主目录 -->
        <file>${LOG_HOME}/error.log</file>
        <!-- 编码器配置，将日志事件转换为指定格式的字符串 -->
        <encoder>
            <!-- 使用前面定义的日志格式模式 -->
            <pattern>${LOG_PATTERN}</pattern>
        </encoder>
        <!-- 过滤器配置，只允许 ERROR 级别的日志通过 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 设置过滤级别为 ERROR -->
            <level>ERROR</level>
            <!-- 当日志级别匹配时，允许通过 -->
            <onMatch>ACCEPT</onMatch>
            <!-- 当日志级别不匹配时，拒绝通过 -->
            <onMismatch>DENY</onMismatch>
        </filter>
        <!-- 滚动策略配置，基于时间进行滚动 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 滚动后的文件命名模式，包含日期 -->
            <fileNamePattern>${LOG_HOME}/error.%d{yyyy-MM-dd}.log</fileNamePattern>
            <!-- 保留的历史错误日志文件的最大天数 -->
            <maxHistory>90</maxHistory>
        </rollingPolicy>
    </appender>

    <!-- 异步Appender配置，用于异步处理日志，提高性能 -->
    <appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
        <!-- 异步队列的大小，即最多可缓存的日志事件数量 -->
        <queueSize>1024</queueSize>
        <!-- 丢弃阈值，当队列剩余空间小于此值时，会丢弃部分日志事件，设置为 0 表示不丢弃 -->
        <discardingThreshold>0</discardingThreshold>
        <!-- 引用前面定义的主文件Appender，将异步处理后的日志输出到该 Appender -->
        <appender-ref ref="FILE" />
    </appender>

    <!-- Logger配置部分，用于指定不同包或类的日志级别和输出目的地 -->
    <!-- 针对 com.example 包及其子包，设置日志级别为 INFO -->
    <logger name="com.example" level="INFO" />
    <!-- 针对 org.springframework 包及其子包，设置日志级别为 WARN -->
    <logger name="org.springframework" level="WARN" />
    <!-- 针对 org.hibernate.SQL 类，设置日志级别为 DEBUG，并关闭日志的追加性 -->
    <logger name="org.hibernate.SQL" level="DEBUG" additivity="false">
        <!-- 只将该类的日志输出到主文件Appender -->
        <appender-ref ref="FILE" />
    </logger>

    <!-- Root Logger配置，是所有 Logger 的父 Logger，设置全局的日志级别和输出目的地 -->
    <root level="INFO">
        <!-- 将日志输出到控制台Appender -->
        <appender-ref ref="CONSOLE" />
        <!-- 将日志异步输出到主文件Appender -->
        <appender-ref ref="ASYNC_FILE" />
        <!-- 将 ERROR 级别的日志输出到错误日志Appender -->
        <appender-ref ref="ERROR_FILE" />
    </root>
</configuration>

5.2 生产环境配置 (logback-spring-prod.xml)

<?xml version="1.0" encoding="UTF-8"?>
<!-- Logback 配置文件的根标签，所有配置项都需包含在其中 -->
<configuration>
    <!-- 使用 springProperty 标签从 Spring 上下文中获取属性值。
         scope="context" 表示从 Spring 上下文获取属性，
         name="appName" 定义了属性名，
         source="spring.application.name" 指定从 Spring 配置中获取名为 spring.application.name 的属性值，
         defaultValue="myApp" 若未获取到属性值，则使用默认值 myApp -->
    <springProperty scope="context" name="appName" source="spring.application.name" defaultValue="myApp"/>

    <!-- 定义日志存储的主目录属性，路径为 /var/log/ 加上前面获取的应用名称 -->
    <property name="LOG_HOME" value="/var/log/${appName}" />
    <!-- 定义日志输出的格式模式，包含日期时间、线程名、日志级别、日志记录器名称和日志消息 -->
    <property name="LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n" />

    <!-- 异步文件输出 Appender 配置，将日志异步写入文件以提高性能 -->
    <appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
        <!-- 异步队列的大小，即最多可缓存的日志事件数量为 512 -->
        <queueSize>512</queueSize>
        <!-- 丢弃阈值，设置为 0 表示不丢弃日志事件 -->
        <discardingThreshold>0</discardingThreshold>
        <!-- 引用名为 FILE 的 Appender，将异步处理后的日志发送到该 Appender -->
        <appender-ref ref="FILE" />
    </appender>

    <!-- 主日志文件 Appender 配置，用于将日志写入文件并支持滚动策略 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 指定日志文件的路径，使用前面定义的日志主目录 -->
        <file>${LOG_HOME}/application.log</file>
        <!-- 编码器配置，将日志事件转换为指定格式的字符串 -->
        <encoder>
            <!-- 使用前面定义的日志格式模式 -->
            <pattern>${LOG_PATTERN}</pattern>
        </encoder>
        <!-- 滚动策略配置，基于文件大小和时间进行滚动 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!-- 滚动后的文件命名模式，包含日期和序号 -->
            <fileNamePattern>${LOG_HOME}/application.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <!-- 单个日志文件的最大大小，超过此大小将进行滚动 -->
            <maxFileSize>50MB</maxFileSize>
            <!-- 保留的历史日志文件的最大天数 -->
            <maxHistory>30</maxHistory>
            <!-- 所有日志文件的总大小上限 -->
            <totalSizeCap>5GB</totalSizeCap>
        </rollingPolicy>
    </appender>

    <!-- 错误日志异步输出 Appender 配置，将错误日志异步写入文件 -->
    <appender name="ASYNC_ERROR_FILE" class="ch.qos.logback.classic.AsyncAppender">
        <!-- 异步队列的大小，即最多可缓存的日志事件数量为 512 -->
        <queueSize>512</queueSize>
        <!-- 丢弃阈值，设置为 0 表示不丢弃日志事件 -->
        <discardingThreshold>0</discardingThreshold>
        <!-- 引用名为 ERROR_FILE 的 Appender，将异步处理后的错误日志发送到该 Appender -->
        <appender-ref ref="ERROR_FILE" />
    </appender>

    <!-- 错误日志文件 Appender 配置，专门用于记录错误日志并支持滚动策略 -->
    <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 指定错误日志文件的路径，使用前面定义的日志主目录 -->
        <file>${LOG_HOME}/error.log</file>
        <!-- 过滤器配置，只允许 ERROR 及以上级别的日志通过 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <!-- 设置过滤级别为 ERROR -->
            <level>ERROR</level>
        </filter>
        <!-- 编码器配置，将日志事件转换为指定格式的字符串 -->
        <encoder>
            <!-- 使用前面定义的日志格式模式 -->
            <pattern>${LOG_PATTERN}</pattern>
        </encoder>
        <!-- 滚动策略配置，基于文件大小和时间进行滚动 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!-- 滚动后的文件命名模式，包含日期和序号 -->
            <fileNamePattern>${LOG_HOME}/error.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <!-- 单个错误日志文件的最大大小，超过此大小将进行滚动 -->
            <maxFileSize>50MB</maxFileSize>
            <!-- 保留的历史错误日志文件的最大天数 -->
            <maxHistory>60</maxHistory>
            <!-- 所有错误日志文件的总大小上限 -->
            <totalSizeCap>10GB</totalSizeCap>
        </rollingPolicy>
    </appender>

    <!-- 邮件通知 Appender 配置，当出现错误日志时发送邮件通知 -->
    <appender name="EMAIL" class="ch.qos.logback.classic.net.SMTPAppender">
        <!-- SMTP 服务器地址 -->
        <smtpHost>smtp.example.com</smtpHost>
        <!-- SMTP 服务器端口 -->
        <smtpPort>587</smtpPort>
        <!-- 发件人邮箱用户名 -->
        <username>user@example.com</username>
        <!-- 发件人邮箱密码 -->
        <password>password</password>
        <!-- 收件人邮箱地址 -->
        <to>admin@example.com</to>
        <!-- 发件人邮箱地址 -->
        <from>noreply@example.com</from>
        <!-- 邮件主题，包含应用名称、日志记录器名称和日志消息 -->
        <subject>${appName} - ERROR: %logger{20} - %m</subject>
        <!-- 邮件内容布局配置 -->
        <layout class="ch.qos.logback.classic.PatternLayout">
            <!-- 邮件内容的格式模式，包含日期时间、线程名、日志级别、日志记录器名称、日志消息和异常信息 -->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n%ex</pattern>
        </layout>
        <!-- 循环缓冲区跟踪器配置，用于缓存一定数量的日志事件 -->
        <cyclicBufferTracker class="ch.qos.logback.core.spi.CyclicBufferTracker">
            <!-- 缓冲区大小，即最多缓存 10 条日志事件 -->
            <bufferSize>10</bufferSize>
        </cyclicBufferTracker>
    </appender>

    <!-- Root Logger 配置，是所有 Logger 的父 Logger，设置全局的日志级别和输出目的地 -->
    <root level="WARN">
        <!-- 将日志异步输出到主日志文件 Appender -->
        <appender-ref ref="ASYNC_FILE" />
        <!-- 将错误日志异步输出到错误日志文件 Appender -->
        <appender-ref ref="ASYNC_ERROR_FILE" />
        <!-- 当出现错误日志时，发送邮件通知 -->
        <appender-ref ref="EMAIL" />
    </root>
</configuration>

收藏？算了算了，这么优秀的文章你肯定记不住（狗头）。

想了解更多的可以关注微信公众号：“Eric的技术杂货库”，后期会有更多的干货以及资料下载。

SpringBoot集成Logback终极指南：从控制台到云端的多维日志输出
十年磨一剑，java开发各种业务系统
03-30 613
【代码】SpringBoot集成Logback终极指南：从控制台到云端的多维日志输出。
企业级全栈开发终极指南：Spring Boot+Vue3+Kubernetes实战，从0到上线高并发系统
最新发布
全栈
03-25 1051
本文系统性解析企业级全栈开发全流程，以高并发电商系统为例，覆盖需求分析、技术选型、开发实现、测试部署等环节。采用Spring Boot 3.0 + MyBatis Plus构建后端，Vue3 + TypeScript实现前端，结合Redis集群、Kubernetes云原生部署及OAuth2.0安全防护体系。提供完整代码仓库与部署脚本，包含秒杀功能、分页查询、JWT认证等核心模块，并附单元测试、压力测试方案及Prometheus监控集成。
SpringBoot Logback配置，SpringBoot日志配置
04-27
NULL 博文链接：https://fanshuyao.iteye.com/blog/2414522
Spring Boot干货系列：（七）默认日志框架配置
热门推荐
AndyLizh的专栏
04-12 4万+
后端编程嘟 2017-04-05 21:53 前言 今天来介绍下Spring Boot如何配置日志logback,我刚学习的时候，是带着下面几个问题来查资料的，你呢 如何引入日志？ 日志输出格式以及输出方式如何配置？ 代码中如何使用？ 正文 Spring Boot在所有内部日志中使用Commons Logging，但是默认配置也
Spring Boot与Logback深度整合：打造高效、安全的日志系统！
Leaton的博客
03-21 604
通过本文的学习，相信大家对 Spring Boot 和 Logback 的整合有了全面的理解。从理论到实践，再到源码分析和细节优化，我们一步步走过了一个完整的实现过程。通过本文的学习，我们全面了解了 Spring Boot 和 Logback 的整合方式，并实现了敏感信息脱敏和异步高效写入的日志系统。Logback 就像是一位专业的“记录员”，默默记录着应用程序的每一步操作，确保我们能够随时回溯问题根源。异步日志写入就像是一个“快递员”，将日志事件快速传递到队列中，由专门的“处理中心”进行包装和投递。
springboot 日志管理之 logback
zwl2220943286的博客
10-12 4895
logback的使用详解，一文教你学会使用logback日志
SpringBoot集成Logback
囚徒之困
03-14 3238
SpringBoot集成Logback
Springboot中使用logback
qq_32740259的博客
03-07 1万+
Springboot中使用logback
【Spring Boot与Apache POI】：操作Excel文件的终极指南
[【Spring Boot与Apache POI】：操作Excel文件的终极指南](https://media.geeksforgeeks.org/wp-content/uploads/20220214105957/SpringBootProducerConsumer.jpg) # 摘要 本文系统地介绍了Spring Boot框架与Apache...
【Spring Boot实用指南】：简化配置与快速部署的终极技巧
![【Spring Boot实用指南】：简化配置与快速部署的终极技巧]...# 1. Spring Boot简介与安装 在现代Java开发领域，Spring Boot已成为构建企业级应用的首选框架。它秉承了Spring生态系统的强大功能，同时简化了配置与部
前后端分离终极指南：Spring Boot与Vue.js的最佳实践
![前后端分离终极指南：Spring Boot与Vue.js的最佳实践]... # 摘要 本文详细阐述了前后端分离的原理和优势，并通过搭建Spring Boot后端与创建Vue.js前端应用，展示了前后端分离的具体实现方式。文中探讨了RESTful API...
spring boot——logback基本配置
深存少年梦
10-24 5441
1. spring boot日志基本了解spring boot内部使用了Commons Logging来记录日志，同样也保留了外部接口集成其他的日志框架，如：Java-Util-Logging,log4j,slf4j以及这次要讲到的logback。想要使用其他的日志框架就必须先得配置，默认情况下会使用logback日志框架1.1 配置控制台日志的debug级别默认情况下控制台是不会输出debug级别
springboot整合Logback
m0_74824091的博客
12-05 1598
Logback是由log4j创始人设计的另外一种开源日志组件，性能比log4j要好。相对是一个可靠、通用、快速而又灵活的Java日志框架。当此属性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。当scan为true时，此属性生效。默认的时间间隔为1分钟。设置Logback在启动和运行过程是否会打印日志。
SpringBoot 配置 Logback
Jitwxs
12-06 2923
一、前言 SLF4J(Simple Logging Facade For Java), 它是针对各类 Java 日志框架的同一抽象，即日志门面。Java 的日志框架众多，SLF4J定义了统一的日志抽象接口。 默认情况下，SpringBoot 采用 Logback 来记录日志，并输出 INFO 级别日志到控制台。从下图可以看到，spring-boot-stater 的依赖中已经包含了 Logback...
Springboot使用logback
qq_55648724的博客
01-07 1242
Logback 是log4j 框架的作者开发的新一代日志框架，它效率更高、能够适应诸多的运行环境，同时天然支持 SLF4J。Logback 的定制性更加灵活，同时也是 SpringBoot 的内置日志框架。
SpringBoot使用logback
qq_43750656的博客
11-20 603
logback日志组件 SpringBoot配置logback
SpringBoot_logback使用
Myron_007的博客
02-18 792
文章目录前言一 Logback默认配置Logback默认配置步骤：指定文件方式二 logback_idea日志输出颜色支持示例logback.xml参考文档 前言 springboot logback使用总结 一 Logback默认配置 参考附录1 Logback默认配置步骤： 尝试在 classpath 下查找文件 logback-test.xml； 如果文件不存在，则查找文件 logback.xml； 如果两个文件都不存在，logback 用 BasicConfigurator 自动对自己进行配置，这
Spring Boot干货系列：（七）默认日志logback配置解析 | 掘金技术征文
weixin_34128501的博客
04-20 1735
原本地址：Spring Boot干货系列：（七）默认日志logback配置解析博客地址：tengj.top/ 前言 今天来介绍下Spring Boot如何配置日志logback,我刚学习的时候，是带着下面几个问题来查资料的，你呢 如何引入日志？ 日志输出格式以及输出方式如何配置？ 代码中如何使用？ 正文 Spring Boot在所有内部日志中使用Commons Logging，但是默认配置...
springboot中集成logback日志配置
jasnet_u的博客
09-03 7027
Logback是log4j框架的作者开发的新一代日志框架，它效率更高、能够适应诸多的运行环境，同时天然支持SLF4J。 默认情况下，Spring Boot会用Logback来记录日志，并用INFO级别输出到控制台。在运行应用程序和其他例子时，你应该已经看到很多INFO级别的日志了。使用logback，需要引入依赖： <dependency> <groupId>org.springframework.boot</groupId> <artifactId&g...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Clf丶忆笙

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值