在 Java 开发早期，我们习惯使用 System.out.println() 来调试代码。但随着项目复杂度提升，简单的打印语句已无法满足生产环境的需求。
为什么日志比 print 更重要
日志不仅仅是记录信息，它是程序运行的'黑匣子'。
- 系统监控：记录运行状态、响应时间，设置阈值报警。
- 数据采集：统计 PV/UV、用户留存，为推荐算法提供原始数据。
- 安全审计：追踪非法攻击或关键数据操作（如谁删除了数据）。
相比标准输出，日志框架提供了时间戳、级别、进程 ID、线程名等关键排查信息，这是 System.out.print 无法比拟的。
日志框架体系：SLF4J 与 Logback
Spring Boot 默认集成了 SLF4J 作为日志门面，并使用 Logback 作为具体实现。
SLF4J 是门面模式的典型应用。它为子系统（如 Log4j、JUL、Logback）提供统一接口，使得客户端无需关心底层实现。这样做的好处是减少系统依赖，提高灵活性，简化客户端使用难度。
| 角色 | 框架名称 | 说明 |
|---|---|---|
| 日志门面 | SLF4J, commons-logging | 统一 API 接口，不含逻辑实现 |
| 日志实现 | Logback, Log4j 1/2, JUL | 负责具体的日志记录逻辑 |
实战：Spring Boot 日志的基本使用
传统方式获取日志对象
需要使用 LoggerFactory 获取，并指定当前类的 Class 对象。注意 Logger 对象必须属于 org.slf4j 包。
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class LoggerController {
// 注意：Logger 对象必须属于 org.slf4j 包
private static final Logger logger = LoggerFactory.getLogger(LoggerController.class);
public String logTest() {
logger.info("这是一条 INFO 级别的日志");
return "Log Success";
}
}
进阶方式：使用 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)
修改日志级别
logging:
level:
root: debug # 将全局日志级别设为 debug
日志持久化
在线上环境中，必须将日志保存到文件。
logging:
file:
name: logger/springboot.log # 指定文件名（推荐使用）
path: D:/temp # 仅指定目录，文件名为默认的 spring.log
日志文件分割
为防止单个日志文件过大（默认超过 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 可以自定义输出格式。
| 占位符 | 说明 |
|---|---|
%d | 日期和时间（精确到毫秒） |
%5p | 日志级别 |
%c | 类的全限定名 |
%m | 日志消息内容 |
总结
- 日志的重要性：它是程序运行的'黑匣子'，是定位问题、审计安全、分析数据的核心依据。
- 最佳实践：推荐使用 Lombok 的
@Slf4j注解，并通过 YAML 配置文件实现日志的级别控制、持久化及滚动拆分。