Spring 日志文件

---

---

日志有什么用？

日志是程序的重要组成部分，想象一下，如果程序报错了，不让你打开控制台看日志，那么你能找到报错的原因吗？

答案是否定的，写程序不是买彩票，不能完全靠猜，因此日志对于我们来说，最主要的用途就是排除和定位问题

除了发现和定位问题之外，我们还可以通过日志实现以下功能：

• 记录用户登录日志，方便分析用户是正常登录还是恶意破解用户
• 记录系统的操作日志，方便数据恢复和定位操作人
• 记录程序的执行时间，方便为以后优化程序提供数据支持

以上这些都是日志提供的非常实用的功能

日志怎么用？

Spring项目在启动的时候，默认就有日志输出：

Spring Boot 输出的控制台日志信息引发三个问题：

• Spring Boot 内置日志框架
• 开发者如何在程序中自定义打印日志
• 如何将默认打印在控制台且无法保存的日志永久保存

自定义日志

自定义日志实现步骤：

1. 在程序中获取日志对象
2. 使用日志对象相关语法打印输出需要内容

在程序中获取日志对象

日志工厂需要将每个类的类型传递进去，这样我们才知道日志的归属类，才能更方便、更直观的定位到问题类

注意：Logger 对象是属于 org.slf4j 包下的，不要导入错包

因为 Spring Boot 中内置了日志框架 Slf4j，所以咱们可以直接在程序中调用 slf4j 来输出日志

常用日志框架说明

组合方案	优势	适用场景
SLF4J + Logback	集成简单（Spring Boot 默认）、性能优	大多数 Spring Boot 项目、中小型应用
SLF4J + Log4j 2	高并发下性能极佳、功能最全	大型企业级应用、高流量系统
SLF4J + JUL	无第三方依赖、轻量	极简 demo 项目、无需复杂日志功能
Commons Logging + Log4j	兼容老项目（如 Spring 3.x 及以前）	老旧项目维护（不推荐新项目使用）

使用日志对象打印日志

控制台效果如下：

日志格式说明

日志级别

日志级别有啥用

• 日志的级别就是为了筛选符合目标的日志信息的。试想一下这样的场景，假设你是一家2万人公司的老板，那么每人员工的日常工作和琐碎的信息都要反馈给你吗？一定不会，因为你根本没有那么多精力。于是就有了组织架构，而组织架构就会分级，有很多的级别设置，如下图所示：
  

• 有了组织架构之后，就可以逐级别汇报消息了，例如：组员汇报给组长；组长汇报给研发一组；研发一组汇报给 Java 研发，等等依次进行汇报

• 而日志分级大概的道理也是一样的，有了日志级别之后就可以过滤自己想看到的信息了，比如设置日志级别为 error，那么就可以只看程序的报错日志了，对于普通的调试日志和业务日志就可以忽略了，从而节省开发者的信息筛选时间

日志级别分类和使用

日志的级别分为：

• trace：微量，少许的意思，级别最低
• info：普通的打印信息
• debug：需要调试时候的关键信息打印
• warn：警告，不影响使用，但需要注意的问题
• error：错误信息，级别较高的错误日志信息
• fatal：致命的，因为代码异常导致程序退出执行的事件

注意⚠️：
越往上，收到的信息就越少

日志的使用

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class UserController {// 1. 注入Logger：参数为当前类的Class，便于定位日志归属private static final Logger logger = LoggerFactory.getLogger(UserController.class);@GetMapping("/login")public String login(String username, String password) {// 2. 打印不同级别的日志// trace：微量信息（如方法进入/退出，默认不输出）logger.trace("进入login方法，参数：username={}, password=***", username);// debug：调试信息（如关键变量值，开发环境常用）logger.debug("验证用户[{}]的密码长度：{}", username, password.length());// info：业务常规信息（如操作成功，生产环境可输出核心业务日志）logger.info("用户[{}]登录成功，IP地址：192.168.1.100", username);// warn：警告信息（如非致命异常、参数不规范，需关注但不影响流程）if (password.length() < 6) {logger.warn("用户[{}]使用弱密码登录，存在安全风险", username);}// error：错误信息（如业务异常、调用失败，需排查问题）try {// 模拟调用数据库失败int result = 1 / 0;} catch (Exception e) {// 打印异常时，需将Exception对象作为最后一个参数传入（便于输出堆栈信息）logger.error("用户[{}]登录时数据库操作失败", username, e);}return "login success";}
}

默认日志输出级别：

• 清除掉配置文件中的日志设置，观察控制台输入的日志级别
• 得到以下结论，日志的输出级别，默认为 info

日志持久化保存

在 Spring Boot 中，日志持久化是指将原本输出到控制台的日志，保存到文件系统中（如磁盘文件），以便后续追溯问题、分析系统运行状态等。以下是实现日志持久化的核心配置和说明：

核心配置方式（application.yml 或 application.properties）
Spring Boot 支持通过简单的配置，指定日志文件的存储目录或具体文件名，底层日志框架（如 Logback、Log4j2）会自动将日志写入对应位置。

1. 配置日志存储目录
   指定日志文件的存储目录，Spring Boot 会在该目录下自动生成默认命名的日志文件（如 spring.log）。

yaml 配置（application.yml）：

logging:file:path: D:/logs/spring-boot  # Windows 路径（注意用 / 或 \\）# 或 Linux/Mac 路径：/var/logs/spring-boot

properties 配置（application.properties）：

logging.file.path=D:/logs/spring-boot
# 或 Linux/Mac：logging.file.path=/var/logs/spring-boot

2. 配置具体日志文件名
   直接指定日志文件的完整路径和文件名，日志会精确写入该文件。

yaml 配置（application.yml）：

logging:file:name: D:/logs/spring-boot/my-app.log  # Windows 路径# 或 Linux/Mac：/var/logs/spring-boot/my-app.log

properties 配置（application.properties）：

logging.file.name=D:/logs/spring-boot/my-app.log
# 或 Linux/Mac：logging.file.name=/var/logs/spring-boot/my-app.log

更简单的日志输出——lombok

每次都使用 LoggerFactory.getLogger(xxx.class) 很繁琐，且每个类都添加一遍，也很麻烦，这里讲一种更好用的日志输出方式，使用 lombok 来更简单的输出。

1. 添加 lombok 框架支持。
2. 使用 @Slf4j 注解输出日志。

• 添加 lombok 依赖

<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.20</version><optional>true</optional>
</dependency>

• 输出日志

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/p")
@Slf4j
public class PersonController {@RequestMapping("/log")public void loggerTest() {log.error("---------------------- error ----------------------");}
}

注意：使用 @Slf4j 注解，在程序中使用 log 对象即可输入日志，并且只能使用 log 对象才能输出，这是 lombok 提供的对象名。

lombok更多注解说明

基本注解	作用
@Getter	自动添加 getter 方法
@Setter	自动添加 setter 方法
@ToString	自动添加 toString 方法
@EqualsAndHashCode	自动添加 equals 和 hashCode 方法
@NoArgsConstructor	自动添加无参构造方法
@AllArgsConstructor	自动添加全属性构造方法，顺序按照属性的定义顺序
@NonNull	属性不能为 null
@RequiredArgsConstructor	自动添加必需属性的构造方法，final + @NonNull 的属性为必需

组合注解	作用
@Data	@Getter + @Setter + @ToString + @EqualsAndHashCode + @RequiredArgsConstructor + @NoArgsConstructor

日志注解	作用
@Slf4j	添加一个名为 log 的日志，使用 slf4j