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");
相关推荐
北漂老男孩7 分钟前
Spring Boot 自动配置深度解析:从源码结构到设计哲学
java·spring boot·后端
unique_落尘7 分钟前
java操作打印机直接打印及详细linux部署(只适用于机器和打印机处于同一个网段中)
java·linux·打印机
小咕聊编程19 分钟前
【含文档+PPT+源码】基于SpringBoot+Vue的移动台账管理系统
java·spring boot·后端
佩奇的技术笔记23 分钟前
Java学习手册:TCP 协议基础
java·tcp/ip
霸道流氓气质25 分钟前
Java中将CST格式的时间字符串进行格式化
java
ACGkaka_25 分钟前
Spring Boot实战(三十六)编写单元测试
spring boot·单元测试·log4j
稻草猫.29 分钟前
【Java 数据结构】泛型
java·数据结构
景天科技苑31 分钟前
【Rust结构体】Rust结构体详解:从基础到高级应用
开发语言·后端·rust·结构体·关联函数·rust结构体·结构体方法
-曾牛33 分钟前
Spring Boot常用注解详解:实例与核心概念
java·spring boot·后端·spring·java-ee·个人开发·spring boot 注解
FL171713141 小时前
Mujoco & robosuite 机器人模型
xml·java·机器人