Spring Boot 日志框架体系与实战配置指南

3.2 进阶方式：使用 Lombok (@Slf4j)

引入 Lombok 依赖后，只需一个注解即可自动生成 log 对象。

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
public class LogController {
    public void log() {
        log.info("使用 Lombok 快速打印日志");
    }
}

四、深入理解日志级别

日志级别按严重程度从高到低排列为：FATAL > ERROR > WARN > INFO > DEBUG > TRACE。

• ERROR：记录较高等级的错误，但不影响系统运行。
• WARN：警告信息，需引起注意。
• INFO：默认级别，记录系统运行的关键节点。
• DEBUG：调试阶段的关键信息。

注意：Spring Boot 默认级别为 INFO，因此默认情况下不会打印 DEBUG 和 TRACE 级别的日志。

五、日志的高级配置 (application.yml)

5.1 修改日志级别

logging:
  level:
    root: debug # 将全局日志级别设为 debug

5.2 日志持久化

在线上环境中，必须将日志保存到文件。

logging:
  file:
    name: logger/springboot.log # 指定文件名（推荐使用）
    path: D:/temp # 仅指定目录，文件名为默认的 spring.log

5.3 日志文件分割

为防止单个日志文件过大（默认超过 10MB 分割），可进行如下配置：

logging:
  logback:
    rollingpolicy:
      max-file-size: 1KB # 达到 1KB 自动分割（实际生产常用 200MB）
      file-name-pattern: ${LOG_FILE}.%d{yyyy-MM-dd}.%i # 分割后的命名格式

六、自定义日志格式说明

通过 logging.pattern.console 或 logging.pattern.file 可以自定义输出格式。

七、总结

1. 日志的重要性：它是程序运行的'黑匣子'，是定位问题、审计安全、分析数据的核心依据。
2. 最佳实践：推荐使用 Lombok 的 @Slf4j 注解，并通过 YAML 配置文件实现日志的级别控制、持久化及滚动拆分。