在现代应用中，日志记录是帮助开发者调试、监控和维护系统的重要工具。Spring Boot 提供了丰富的日志功能，默认集成了 SLF4J 和 Logback，使得开发者能够轻松配置和管理日志。

1. 日志概念

日志是记录应用程序在运行过程中生成的相关信息。它通常包括时间、线程、日志级别、类名、方法名等，有助于在出现问题时定位问题来源。日志的核心目标是记录系统的运行状态和事件，帮助分析系统行为。

Spring Boot 默认使用的日志框架是 SLF4J（Simple Logging Facade for Java），它为多种日志实现（如 Logback、Log4j、Log4j2 等）提供了统一的接口。默认情况下，Spring Boot 使用 Logback 作为日志实现。

2. 日志级别

日志级别定义了日志的严重程度。常见的日志级别从高到低分别为：

• ERROR: 严重错误，通常是影响程序运行的异常。
• WARN: 警告信息，提示可能出现的问题。
• INFO: 运行时的常规信息，表明程序的正常运行。
• DEBUG: 调试信息，通常用于开发环境中，包含更详细的系统运行信息。
• TRACE: 更细粒度的调试信息，比 DEBUG 级别更详细。

3. 日志格式

日志格式可以根据需要进行自定义。一般包含以下信息：

• 时间戳
• 线程名
• 日志级别
• 日志记录类的名称
• 日志信息

4. 日志分组（Logging Group）

在 Spring Boot 中，可以将不同的包或类分配到不同的日志分组。通过这种方式，可以对不同分组的日志设置不同的日志级别。示例如下：

logging:
  group:
    web: "org.springframework.web, org.hibernate"
  level:
    web: DEBUG

上面的配置将 org.springframework.web 和 org.hibernate 包的日志分组为 web，并将其日志级别设置为 DEBUG。

5. 日志输出到文件

Spring Boot 支持将日志输出到控制台、文件或远程服务器。将日志输出到文件非常常见，以下是一个配置示例：

logging:
  file:
    name: logs/application.log
  level:
    root: INFO

此配置将所有日志输出到 logs/application.log 文件中。

6. 日志归档

日志文件可能会随着时间变得庞大，归档机制可以将日志文件定期压缩并保存。可以通过配置 Logback 的 rollingPolicy 来实现日志归档，例如每天归档一次：

<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>logs/application.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <!-- 日志文件命名 -->
        <fileNamePattern>logs/application.%d{yyyy-MM-dd}.log</fileNamePattern>
        <!-- 保留30天的归档日志 -->
        <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>

此配置会每天创建一个新的日志文件，并保留 30 天的归档日志。

7. 日志切割（Log Splitting）

日志切割是指当日志文件达到一定大小时自动切割成多个文件。这可以防止单个日志文件过大，以下是通过大小切割日志文件的示例：

<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>logs/application.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
        <!-- 当日志文件达到10MB时切割 -->
        <maxFileSize>10MB</maxFileSize>
    </rollingPolicy>
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>

8. 切换日志实现

Spring Boot 默认使用 Logback 作为日志实现，但可以轻松切换为其他日志框架，如 Log4j2 或 Log4j。

要切换为 Log4j2，只需在 pom.xml 中引入相应的依赖，并排除 Logback 依赖：

<dependencies>
    <!-- 引入Log4j2依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
    </dependency>

    <!-- 排除Logback依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
        <exclusions>
            <exclusion>
                <groupId>ch.qos.logback</groupId>
                <artifactId>logback-classic</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

9. 示例代码

以下是一个 Spring Boot 应用中的日志配置示例：

application.yml：

logging:
  file:
    name: logs/application.log
  level:
    root: INFO
    com.example.demo: DEBUG
  pattern:
    console: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"
    file: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"

logback-spring.xml：

<configuration>
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/application.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/application.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

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

DemoApplication.java：

package com.example.demo;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {

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

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
        logger.info("Application started");
        logger.debug("This is a debug message");
        logger.error("This is an error message");
    }
}

结论

Spring Boot 提供了强大而灵活的日志支持，通过简单的配置可以实现日志级别控制、日志分组、日志输出到文件、归档、切割等功能。此外，还可以根据需求切换日志实现，增强应用的日志管理能力。