1. 日志系统概述
日志是程序运行过程中记录关键信息的机制，相当于程序的"黑匣子"。想象一下飞机失事后调查人员第一时间寻找黑匣子的场景，日志对于程序员排查问题同样重要。在Spring Boot应用中，日志系统主要承担以下核心职责：
- 问题诊断：当系统出现异常时，通过日志可以快速定位问题源头
- 行为审计：记录用户操作轨迹，满足合规性要求
- 性能监控：记录方法执行时间等指标，为优化提供数据支撑
- 运行状态跟踪：实时了解系统健康状态
Spring Boot默认集成了SLF4J日志门面和Logback日志实现，这种组合是目前Java生态中最主流的日志解决方案。SLF4J作为抽象层，允许我们在不修改代码的情况下更换底层日志实现，提供了良好的扩展性。
提示：虽然System.out.println()也可以输出信息，但在生产环境中绝对不要使用它记录日志。这种方式无法控制输出级别、不支持格式化、性能较差且难以集中管理。
2. 日志基础使用
2.1 获取日志对象
正确的日志对象获取方式是通过LoggerFactory：
java复制import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@RestController
public class UserController {
// 推荐使用final修饰
private static final Logger logger = LoggerFactory.getLogger(UserController.class);
// 类方法...
}
这里有几个关键点需要注意：
- 每个类应该有自己的Logger实例，传入当前类Class对象有助于定位日志来源
- 声明为static final避免重复创建实例
- 变量名通常使用log或logger，保持团队统一风格
2.2 日志级别详解
SLF4J定义了6种日志级别（从低到高）：
| 级别 | 使用场景 | 生产环境建议 |
|---|---|---|
| TRACE | 最详细的调试信息 | 关闭 |
| DEBUG | 开发调试关键信息 | 按需开启 |
| INFO | 常规运行信息（默认级别） | 开启 |
| WARN | 潜在问题但不影响运行 | 开启 |
| ERROR | 业务错误但系统仍可运行 | 开启 |
| FATAL | 致命错误导致系统不可用（SLF4J不支持） | 开启 |
配置日志级别示例（application.yml）：
yaml复制logging:
level:
root: info
com.example.demo: debug # 特定包使用不同级别
3. 高级日志配置
3.1 日志持久化
生产环境必须将日志持久化到文件，配置示例：
yaml复制logging:
file:
name: logs/app.log # 日志文件路径
pattern:
file: "%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{50} - %msg%n"
logback:
rollingpolicy:
max-file-size: 10MB
max-history: 30
关键配置说明：
- 使用rolling policy实现日志分割
- 建议单个文件不超过50MB
- 保留最近7-30天的日志
- 日志格式应包含时间、线程、级别、类名等信息
3.2 日志格式定制
日志模式字符串中各符号含义：
- %d：日期时间
- %thread：线程名
- %-5level：左对齐的日志级别
- %logger{50}：类名缩写（最长50字符）
- %msg：日志消息
- %n：换行符
示例输出：
code复制2023-08-20 14:30:45 [http-nio-8080-exec-1] INFO c.e.d.UserController - 用户登录成功
4. Lombok日志优化
4.1 @Slf4j注解使用
添加Lombok依赖后：
xml复制<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
简化日志声明：
java复制@Slf4j
@RestController
public class AuthController {
@PostMapping("/login")
public ResponseEntity<String> login(@RequestBody LoginDTO dto) {
log.debug("登录请求参数: {}", dto);
// 业务逻辑...
}
}
4.2 Lombok原理分析
Lombok在编译期通过注解处理器自动生成代码：
- 编译时检测@Slf4j注解
- 自动生成private static final Logger log字段
- 使用当前类名初始化Logger
可以通过查看target/classes目录下的编译结果验证这个过程。这种设计使得代码更简洁，同时不影响运行时性能。
4.3 其他常用Lombok注解
| 注解 | 等效代码 |
|---|---|
| @Getter/@Setter | 生成get/set方法 |
| @ToString | 生成toString() |
| @EqualsAndHashCode | 生成equals()和hashCode() |
| @Data | 包含上述所有+@RequiredArgsConstructor |
5. 日志最佳实践
-
避免字符串拼接：使用占位符提升性能
java复制// 不推荐 log.debug("User " + userId + " accessed " + resource); // 推荐 log.debug("User {} accessed {}", userId, resource); -
合理控制日志级别：
- 生产环境通常设置INFO级别
- 调试时临时开启DEBUG级别
- 避免在循环中记录DEBUG日志
-
敏感信息过滤：
java复制// 不安全的写法 log.info("用户登录，手机号：{}", phoneNumber); // 安全写法 log.info("用户登录，手机号尾号：{}", phoneNumber.substring(7)); -
异常日志规范：
java复制try { // 业务代码 } catch (BusinessException e) { log.error("业务处理失败，订单ID：{}", orderId, e); throw e; } -
日志监控建议：
- 使用ELK等工具集中管理日志
- 设置ERROR日志告警
- 定期分析日志模式优化系统
6. 常见问题排查
-
日志不输出：
- 检查logging.level配置
- 确认logback.xml没有覆盖配置
- 检查日志文件权限
-
日志文件不滚动：
- 检查max-file-size配置
- 确认磁盘空间充足
- 检查文件锁是否被占用
-
Lombok日志不工作：
- 确认IDE安装了Lombok插件
- 检查注解处理器是否启用
- 尝试mvn clean compile重新编译
-
日志性能问题：
- 避免同步阻塞的Appender
- 考虑使用AsyncAppender
- 减少不必要的日志输出
在实际项目中，我遇到过因不当的日志配置导致磁盘爆满的情况。后来我们建立了日志规范：所有日志必须配置滚动策略，ERROR日志单独存储，并设置定时清理任务。这些经验教训让我深刻认识到，看似简单的日志管理，实际上需要系统化的设计思路。