Spring Boot 日志体系与实战指南
在 Java 开发初期，System.out.println() 曾是调试的标配。但随着项目规模扩大，这种简单输出在生产环境中几乎成了摆设——它缺少时间戳、线程信息，更无法区分日志级别。真正的日志系统不仅是打印文本，更是系统的'黑匣子'，负责监控运行状态、审计用户操作以及为故障排查提供关键线索。
一、日志框架：门面模式与实现
Spring Boot 默认集成了 SLF4J 作为日志门面（Facade），底层则使用 Logback 进行具体实现。理解这两者的关系至关重要。
SLF4J 是门面模式的典型应用。它定义了一套统一的 API 接口，屏蔽了底层 Log4j、JUL 或 Logback 的差异。这意味着你的代码只依赖 SLF4J，更换底层实现时只需调整依赖配置，无需修改业务代码。这种设计极大地降低了耦合度，提高了系统的灵活性。
| 角色 | 常见框架 | 说明 |
|---|---|---|
| 日志门面 | SLF4J, commons-logging | 统一 API 接口，不含逻辑实现 |
| 日志实现 | Logback, Log4j 2, JUL | 负责具体的日志记录逻辑 |
二、实战：如何优雅地获取日志对象
1. 传统方式
最基础的做法是通过 LoggerFactory 获取 Logger 实例。这里有个坑：必须确保导入的是 org.slf4j.Logger，而不是其他包下的同名类。
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";
}
}
2. 进阶方式：Lombok @Slf4j
如果项目中引入了 Lombok 依赖，推荐使用 @Slf4j 注解。它能自动在编译期生成 log 字段，省去手动初始化 Logger 的繁琐步骤，让代码更清爽。
