Spring Boot 自定义日志打印(日志级别、logback-spring.xml 文件、自定义日志打印解读)

一、Logback

  1. 在 Spring Boot 中,日志框架默认使用的是 Logback,Spring Boot 提供了对日志配置的简化

  2. Spring Boot 默认会将日志输出到控制台,并且日志级别为 INFO

  3. 可以在 application.yamlapplication.properties 文件中进行日志配置

  4. 如果需要自定义日志配置,可以使用 logback-spring.xml 文件,Spring Boot 会自动加载该文件


二、日志级别

1、基本介绍
(1)INFO
  1. 一般信息,用于记录应用程序的运行状态

  2. 适用于记录应用程序的关键事件,例如,启动、关闭、重要配置加载等

  3. 用于提供足够信息,帮助了解应用状态,同时避免过多细节

(2)WARN
  1. 警告信息,表示潜在的问题

  2. 适用于记录潜在的问题,例如,配置不当、资源不足等,这些问题不会立即影响运行,但需关注

  3. 用于帮助发现并预防潜在问题

(3)ERROR
  1. 错误信息,表示发生了错误,但应用程序仍可运行

  2. 适用于记录严重错误,如数据库连接失败、关键业务逻辑异常等

  3. 用于快速定位和解决重大问题

(4)DEBUG
  1. 调试信息,用于开发阶段

  2. 适用于调试时,记录详细执行流程、变量值等

  3. 通常关闭,避免日志量过大,必要时可临时开启

(5)TRACE
  1. 最详细的日志信息,通常用于调试

  2. 适用于记录最详细的执行信息,用于深度调试

  3. 一般不开启,除非有特殊需求

2、小结
  1. 应选择合适的日志级别以确保既能捕获关键信息,又不会产生过多冗余日志

  2. 生产环境通常设置为 INFO

  3. 可根据需求调整特定包的日志级别,例如,将某些复杂模块设为 DEBUG


三、Spring Boot 自定义日志打印

1、配置文件
  • logback-spring.xml 文件中配置如下内容
xml 复制代码
<?xml version="1.0" encoding="UTF-8"?>
<configuration>

    <!-- 定义日志输出格式 -->
    <property name="CONSOLE_PATTERN" value="[%-5p] %d{yyyy-MM-dd HH:mm:ss} - %m%n"/>
    <property name="FILE_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5p %logger{1}:%line - %m%n"/>

    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${CONSOLE_PATTERN}</pattern>
        </encoder>
    </appender>

    <!-- 每日滚动文件输出 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>d:/my-logs/application.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>d:/my-logs/application.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory> <!-- 保留历史日志文件的最大天数 -->
        </rollingPolicy>
        <encoder>
            <pattern>${FILE_PATTERN}</pattern>
        </encoder>
    </appender>

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

</configuration>
2、测试代码
java 复制代码
@Component
public class LogTest {

    private static final Logger logger = LoggerFactory.getLogger(LogTest.class);

    @PostConstruct
    public void test1() {
        logger.debug("This is a debug message");
        logger.info("This is an info message");
        logger.warn("This is a warning message");
        logger.error("This is an error message");
    }
}

四、Spring Boot 自定义日志打印解读

1、配置文件
(1)定义日志输出格式
xml 复制代码
<property name="CONSOLE_PATTERN" value="[%-5p] %d{yyyy-MM-dd HH:mm:ss} - %m%n"/>
<property name="FILE_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5p %logger{1}:%line - %m%n"/>
  • CONSOLE_PATTERN 是控制台日志的输出格式
  1. %-5p:日志级别(例如,INFO、ERROR),左对齐,占 5 个字符

  2. %d{yyyy-MM-dd HH:mm:ss}:日志时间戳

  3. %m:日志消息

  4. %n:换行符

    输出示例

    [INFO ] 2023-10-01 12:34:56 - This is a log message

  • FILE_PATTERN 是文件日志的输出格式。
  1. %d{yyyy-MM-dd HH:mm:ss}:日志时间戳

  2. [%thread]:当前线程名

  3. %-5p:日志级别

  4. %logger{1}:%line:日志记录器的名称(只显示最后一部分)和代码行号

  5. %m:日志消息

  6. %n:换行符

    输出示例

    2023-10-01 12:34:56 [main] INFO com.example.MyClass:42 - This is a log message

(2)控制台输出配置
xml 复制代码
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>${CONSOLE_PATTERN}</pattern>
    </encoder>
</appender>
  1. CONSOLE:定义一个名为 CONSOLE 的日志输出目标,输出到控制台

  2. ConsoleAppender:将日志输出到控制台

  3. encoder:定义日志的输出格式,使用前面定义的 CONSOLE_PATTERN

(3)文件输出配置
xml 复制代码
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>d:/my-logs/application.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>d:/my-logs/application.%d{yyyy-MM-dd}.log</fileNamePattern>
        <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
        <pattern>${FILE_PATTERN}</pattern>
    </encoder>
</appender>
  1. FILE:定义一个名为 FILE 的日志输出目标,输出到文件

  2. RollingFileAppender:支持日志文件滚动(按时间或大小分割)

  3. file:当前日志文件的路径为 d:/my-logs/application.log

  4. rollingPolicy:定义日志滚动策略

  5. TimeBasedRollingPolicy:按时间滚动日志文件

  6. fileNamePattern:滚动后的日志文件命名格式,例如 application.2023-10-01.log

  7. maxHistory:保留最近 30 天的日志文件,超过 30 天的文件会被自动删除

  8. encoder:定义日志的输出格式,使用前面定义的 FILE_PATTERN

(4)根日志配置
xml 复制代码
<root level="info">
    <appender-ref ref="CONSOLE"/>
    <appender-ref ref="FILE"/>
</root>
  1. root:定义根日志记录器

  2. level="info":设置日志级别为 INFO,即只记录 INFO 及以上级别(例如,WARN、ERROR)的日志

  3. appender-ref:将日志输出到 CONSOLEFILE 两个目标

2、测试代码
(1)创建 Logger 实例
java 复制代码
private static final Logger logger = LoggerFactory.getLogger(LogTest.class);
  1. LoggerFactory 是 SLF4J 提供的工厂类,用于创建 Logger 实例

  2. getLogger(LogTest.class) 方法会根据传入的类(LogTest.class)创建一个与该类关联的 Logger 实例

  3. 日志输出时会自动带上类名(LogTest),方便定位日志来源

(2)打印日志
java 复制代码
logger.debug("This is a debug message");
logger.info("This is an info message");
logger.warn("This is a warning message");
logger.error("This is an error message");
相关推荐
深海潜水员30 分钟前
【Python】 切割图集的小脚本
开发语言·python
27669582921 小时前
东方航空 m端 wasm req res分析
java·python·node·wasm·东方航空·东航·东方航空m端
许苑向上1 小时前
Spring Boot 自动装配底层源码实现详解
java·spring boot·后端
Yolo566Q1 小时前
R语言与作物模型(以DSSAT模型为例)融合应用高级实战技术
开发语言·经验分享·r语言
喵叔哟1 小时前
31.【.NET8 实战--孢子记账--从单体到微服务--转向微服务】--单体转微服务--财务服务--收支分类
java·微服务·.net
Felven1 小时前
C. Challenging Cliffs
c语言·开发语言
星月昭铭2 小时前
Spring AI调用Embedding模型返回HTTP 400:Invalid HTTP request received分析处理
人工智能·spring boot·python·spring·ai·embedding
Dreamsi_zh2 小时前
Python爬虫02_Requests实战网页采集器
开发语言·爬虫·python
codu4u13142 小时前
Maven中的bom和父依赖
java·linux·maven
呦呦鹿鸣Rzh2 小时前
微服务快速入门
java·微服务·架构