玩转 SpringBoot 日志：级别划分、持久化、格式配置及 Lombok 简化使用

犬小哈

111人浏览 · 2025-11-13 09:30:54

犬小哈 · 2025-11-13 09:30:54 发布

来源：https://blog.csdn.net/2503_90322569

👉 欢迎加入小哈的星球，你将获得: 专属的项目实战（多个项目） / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目：《Spring AI 项目实战》正在更新中..., 基于 Spring AI + Spring Boot 3.x + JDK 21;
《从零手撸：仿小红书（微服务架构）》已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17..., 点击查看项目介绍；演示地址：http://116.62.199.48:7070/
《从零手撸：前后端分离博客项目（全栈开发）》 2期已完结,演示链接：http://116.62.199.48/;
专栏阅读地址：https://www.quanxiaoha.com/column

截止目前，累计输出 100w+ 字，讲解图 4013+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，Spring Cloud Alibaba 等等，戳我加入学习，解锁全部项目，已有4000+小伙伴加入

一、日志概述

为什么要学习日志

日志对我们来说并不陌生，从JavaSE部分，我们就在使用 System.out.print 来打印日志了。通过打印日志来发现和定位问题，或者根据日志来分析程序的运行过程。在Spring的学习中，也经常根据控制台的日志来分析和定位问题。

随着项目的复杂度提升，我们对日志的打印也有了更高的需求，而不仅仅是定位排查问题。

比如需要记录一些用户的操作记录（一些审计公司会要求），也可能需要使用日志来记录用户的一些喜好，把日志持久化，后续进行数据分析等。但是 System.out.print 不能很好的满足我们的需求，我们就需要使用一些专门日志框架（专业的事情交给专业的人去做）。

日志的用途

通过前面的学习，我们知道日志主要是为了发现问题，分析问题，定位问题的，但除此之外，日志还有很多用途

1. 系统监控

监控现在几乎是一个成熟系统的标配，我们可以通过日志记录这个系统的运行状态，每一个方法的响应时间，响应状态等，对数据进行分析，设置不同的规则，超过阈值时进行报警。比如统计日志中关键字的数量，并在关键字数量达到一定条件时报警，这也是日志的常见需求之一

2. 数据采集

数据采集是一个比较大的范围，采集的数据可以作用在很多方面，比如数据统计，推荐排序等。

数据统计： 统计页面的浏览量(PV)，访客量(UV)，点击量等，根据这些数据进行数据分析，优化公司运营策略
推荐排序： 目前推荐排序应用在各个领域，我们经常接触的各行各业很多也都涉及推荐排序，比如购物，广告，新闻等领域。数据采集是推荐排序工作中必须做的一环，系统通过日志记录用户的浏览历史，停留时长等，算法人员通过分析这些数据，训练模型，给用户做推荐。

下图中的数据源，其中一部分就来自于日志记录的数据。

图片

3. 日志审计

随着互联网的发展，众多企业的关键业务越来越多的运行于网络之上。网络安全越来越受到大家的关注，系统安全也成为了项目中的一个重要环节，安全审计也是系统中非常重要的部分。国家的政策法规、行业标准等都明确对日志审计提出了要求。通过系统日志分析，可以判断一些非法攻击，非法调用，以及系统处理过程中的安全隐患。

比如，大家平时都在做运营系统，其中运营人员在通过界面处理一些数据的时候，如果没有清楚的日志操作记录，一条数据被删除或者修改，你是无法找到是谁操作的，但是如果你做了相应的记录，该数据被谁删除或者修改就会一目了然。

还有一些内部的违规和信息泄漏（比如客户信息被卖掉）现象出现后，如果未记录留存日志，为事后调查提供依据，则事后很难追查（一些公司查看客户的信息都会被记录日志，如果频繁查询也会报警）

二、日志使用

SpringBoot项目启动的时候默认就有日志输出

图片

它所打印的日志和我们用sout打印的有什么区别呢

图片

可以看到，我们通过 System.out.print 打印的日志，比 SpringBoot 打印的日志缺少了很多信息。

SpringBoot 内置了日志框架 Slf4j，我们可以直接在程序中调用 Slf4j 来输出日志

1.打印日志

打印日志的步骤：

在程序中得到日志对象。
使用日志对象输出要打印的内容。

在程序中得到日志对象

在程序中获取日志对象需要使用日志工厂 LoggerFactory，如下代码所示：

private static Logger logger = LoggerFactory.getLogger(LoggerController.class);

LoggerFactory.getLogger 需要传递一个参数，标识这个日志的名称这样可以更清晰的知道是哪个类输出的日志。当有问题时，可以更方便直观的定位到问题类

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

使用日志对象打印日志

日志对象的打印方法有很多种，我们可以先使用 info() 方法来输出日志，如下代码所示：

@RestController
public class LoggerController {

    private static Logger logger =
            LoggerFactory.getLogger(LoggerController.class);
    @RequestMapping("/logger")
    public String logger(){
        logger.info("--------------------要输出日志的内容--------------------");
        return "打印日志";
    }
}

图片

2.日志框架(了解即可)

1).门面模式

图片

SLF4J不同于其他日志框架，它不是一个真正的日志实现，而是一个抽象层，对日志框架制定的一种规范,标准,接口。所有SLF4J并不能独立使用，需要和具体的日志框架配合使用。

门面模式(外观模式)

SLF4J是门面模式的典型应用(但不仅仅使用了门面模式)。

门面模式定义

门面模式（Facade Pattern）又称为外观模式，提供了一个统一的接口，用来访问子系统中的一群接口。其主要特征是定义了一个高层接口，让子系统更容易使用。

图片

门面模式主要包含2种角色：

外观角色(Facade)： 也称门面角色，系统对外的统一接口。
子系统角色(SubSystem)： 可以同时有一个或多个 SubSystem。每个 SubSytem 都不是一个单独的类，而是一个类的集合。SubSystem 并不知道 Facade 的存在，对于 SubSystem 而言，Facade 只是另一个客户端而已(即 Facade 对 SubSystem 透明)

比如去医院看病，可能要去挂号，门诊，化验，取药，让患者或患者家属觉得很复杂，如果有提供接待人员，只让接待人员来处理，就很方便。

门面模式的优点

减少了系统的相互依赖： 实现了客户端与子系统的耦合关系，这使得子系统的变化不会影响到调用它的客户端。
提高了灵活性： 简化了客户端对子系统的使用难度，客户端无需关心子系统的具体实现方式，而只需要和门面对象交互即可。
提高了安全性： 可以灵活设定访问权限，不在门面对象中开通方法，就无法访问。

2).SLF4J 框架介绍

SLF4J 就是其他日志框架的门面，SLF4J 可以理解为是提供日志服务的统一API接口, 并不涉及到具体的日志逻辑实现。

不引入日志门面

常见的日志框架有log4J, logback等。如果一个项目已经使用了log4j，而你依赖的另一个类库，假如是 Apache Active MQ, 它依赖于另外一个日志框架logback, 那么你就需要把logback也加载进去。

图片

存在问题:

不同日志框架的API接口和配置文件不同，如果多个日志框架共存，那么不得不维护多套配置文件(这个配置文件是指用户自定义的配置文件)。
如果要更换日志框架，应用程序将不得不修改代码，并且修改过程中可能会存在一些代码冲突。
如果引入的第三方框架，使用了多套，那就不得不维护多套配置。

引入日志门面

引入门面日志框架之后，应用程序和日志框架(框架的具体实现)之间有了统一的API接口(门面日志框架实现)，此时应用程序只需要维护一套日志文件配置，且当底层实现框架改变时，也不需要更改应用程序代码。

图片

三、日志的格式说明

图片

打印日志的这些部分都代表着什么呢?

从上图可以看到，日志输出内容元素具体如下：

时间日期：精确到毫秒
日志级别：ERROR, WARN, INFO, DEBUG 或 TRACE
进程ID
线程名
Logger名(通常使用源代码的类名)
日志内容

四、日志级别

日志级别代表着日志信息对应问题的严重性，为了更快的筛选符合目标的日志信息。

试想一下这样的场景，假设你是一家2万人公司的老板，如果每个员工的日常工作和琐碎的信息都要反馈给你，那你一定无暇顾及。于是就有了组织架构，而组织架构就会分级，有很多的级别设置，如下图所示：

图片

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

日志级别大概是同样的道理，有了日志级别之后就可以过滤自己想看到的信息了，比如只关注error级别的，就可以根据级别过滤出来error级别的日志信息，节约开发者的信息筛选时间。

1. 日志级别的分类

日志的级别从高到低依次为: FATAL、ERROR、WARN、INFO、DEBUG、TRACE

FATAL: 致命信息，表示需要立即被处理的系统级错误。
ERROR: 错误信息，级别较高的错误日志信息，但仍然不影响系统的继续运行。
WARN: 警告信息, 不影响使用, 但需要注意的问题。
INFO: 普通信息，用于记录应用程序正常运行时的一些信息，例如系统启动完成、请求处理完成等。
DEBUG: 调试信息，需要调试时候的关键信息打印。
TRACE: 追踪信息，比DEBUG更细粒度的信息事件(除非有特殊用意，否则请使用DEBUG级别替代)。

日志级别通常和测试人员的Bug级别没有关系。

日志级别是开发人员设置的，用来给开发人员看的。日志级别的正确设置，也与开发人员的工作经验有关。如果开发人员把error级别的日志设置成了info，就很有可能会影响开发人员对项目运行情况的判断。出现error级别的日志信息较多时，可能也没有任何问题。测试的bug级别更多是依据现象和影响范围来判断。

日志级别的顺序：

图片

级别越高，收到的消息越少。

2. 日志级别的使用

日志级别是开发人员自己设置的，开发人员根据自己的理解来判断该信息的重要程度。

类似公司管理，通常由领导来判断什么样的事情需要汇报，什么样的事情不需要汇报。

针对这些级别，Logger对象分别提供了对应的方法，来输出日志。

@RequestMapping("/printLog")
    public String printLog(){
        logger.trace("=====trace=====");
        logger.debug("=====debug=====");
        logger.info("=====info=====");
        logger.warn("=====warn=====");
        logger.error("=====error=====");

        return "打印不同级别的日志";
    }

}

SpringBoot 默认的日志框架是Logback，Logback没有 FATAL 级别，它被映射到 ERROR。

出现fatal日志，表示服务已经出现了某种程度的不可用，需要系统管理员紧急介入处理。通常情况下，一个进程生命周期中应该最多只有一次FATAL记录。

观察日志结果:

图片

五、日志配置

上述是日志的使用,日志框架支持我们更灵活的输出日志,包括内容,格式等.

1. 配置日志级别

日志级别配置只需要在配置文件中设置"logging.level"配置项即可，如下所示：

properties 和 yml 只需要配置其中一个即可。二者转换方式: Properties文件的点(.) 对应 yml 文件中的换行

以下两个配置，根据项目使用其中之一。

Properties配置

logging.level.root=debug

yml配置

logging:
  level:
    root: debug

配置好之后，重新运行上述代码

图片

2.日志持久化

以上的日志都是输出在控制台上的，然而在线上环境中，我们需要把日志保存下来，以便出现问题之后追溯问题。把日志保存下来就叫持久化。

日志持久化有两种方式

配置日志文件名
配置日志的存储目录

图片

配置日志文件的路径和文件名：

Properties配置

logging.file.name=logger/springboot.log

yml配置

# 设置日志文件的文件名
logging:
  file:
    name: logger/springboot.log

后面可以跟绝对路径或者相对路径

图片

配置日志文件的保存路径

Properties配置

logging.file.path=D:/temp

yml配置

# 设置日志文件的目录
logging:
  file:
    path: D:/temp

这种方式只能设置日志的路径，文件名为固定的spring.log

运行程序，该路径下多出一个日志文件: spring.log

图片

注意:

logging.file.name 和 logging.file.path 两个都配置的情况下,只生效其一,以 logging.file.name 为准.

3. 配置日志文件分割

如果我们的日志都放在一个文件中，随着项目的运行，日志文件会越来越大，需要对日志文件进行分割。

当然，日志框架也帮我们考虑到了这一点，所以如果不进行配置，就走自动配置

默认日志文件超过10M就进行分割

配置项	说明	默认值
`logging.logback.rollingpolicy.file-name-pattern`	日志分割后的文件名格式	`${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz`
`logging.logback.rollingpolicy.max-file-size`	日志文件超过这个大小就自动分割	10MB

配置日志文件分割:

Properties配置

logging.logback.rollingpolicy.file-name-pattern=${LOG_FILE}.%d{yyyy-MM-dd}.%i
logging.logback.rollingpolicy.max-file-size=1KB

yml配置

logging:
  logback:
    rollingpolicy:
      max-file-size: 1KB
      file-name-pattern: ${LOG_FILE}.%d{yyyy-MM-dd}.%i

日志文件超过1KB就分割(设置1KB是为了更好展示。企业开发通常设置为200M、500M等，此处没有明确标准)
分割后的日志文件名为: 日志名.日期.索引

4. 配置日志格式

目前日志打印的格式是默认的

2023-09-21 11:42:16.268  INFO 21464 --- [nio-8080-exec-6] c.e.demo.controller.LoggerController     : ================ info ================
2023-09-21 11:42:16.270  WARN 21464 --- [nio-8080-exec-6] c.e.demo.controller.LoggerController     : ================ warn ================
2023-09-21 11:42:16.270 ERROR 21464 --- [nio-8080-exec-6] c.e.demo.controller.LoggerController     : ================ error ================

打印日志的格式，也是支持配置的。支持控制台和日志文件分别设置。

配置项	说明	默认值
logging.pattern.console	控制台日志格式	`%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd'T'HH:mm:ss.SSSXXX}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}`
logging.pattern.file	日志文件的日志格式	`%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd'T'HH:mm:ss.SSSXXX}} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39}: %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}`

配置项说明:

1.%clr(表达式){颜色} 设置输入日志的颜色

支持颜色有以下几种:

blue
cyan
faint
green
magenta
red
yellow

2.%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd'T'HH:mm:ss.SSSXXX}} 日期和时间–精确到毫秒

%d{} 日期
${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd 'T' HH:mm:ss.SSSXXX} 非空表达式,获取系统属性 LOG_DATEFORMAT_PATTERN, 若属性 LOG_DATEFORMAT_PATTERN 不存在，则使用 yyyy-MM-dd HH:mm:ss.SSSXXX 格式，系统属性可以通过 System.getProperty("LOG_DATEFORMAT_PATTERN") 获取。

3.%5p 显示日志级别ERROR, WARN, INFO, DEBUG, TRACE.

4.%t 线程名, %c 类的全限定名。 %M method. %L 为行号. %thread 线程名称. %m 或者 %msg 显示输出消息. %n 换行符

5.%5 若字符长度小于5，则右边用空格填充. %-5 若字符长度小于5，则左边用空格填充. %.15 若字符长度超过15，截去多余字符. %15.15 若字符长度小于15，则右边用空格填充. 若字符长度超过15，截去多余字符

我们这里就举一个例子

图片

不同级别的日志显示的颜色不同

六、更简单的日志输出

每次都使用 LoggerFactory.getLogger(xxx.class) 很繁琐，且每个类都添加一遍，lombok给我们提供了一种更简单的方式。

添加 lombok 框架支持
使用 @slf4j 注解输出日志。

1. 添加 lombok 依赖

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

2. 输出日志

@Slf4j
@RestController
public class LogController {
    public void log(){
        log.info("===========要输出日志的内容===========");
    }
}

lombok提供的 @Slf4j 会帮我们提供一个日志对象 log，我们直接使用就可以。

图片

总结

日志是程序中的重要组成部分，使用日志可以快速的发现和定位问题，Spring Boot 内置了日志框架，默认情况下使用的是 info 日志级别将日志输出到控制台的，我们可以通过 lombok 提供的 @Slf4j 注解和 log 对象快速的打印自定义日志。

日志包含6个级别,日志级别越高，收到的日志信息也就越少，我们可以通过配置日志的保存名称或保存目录来将日志持久化。

👉 欢迎加入小哈的星球，你将获得: 专属的项目实战（多个项目） / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目：《Spring AI 项目实战》正在更新中..., 基于 Spring AI + Spring Boot 3.x + JDK 21;
《从零手撸：仿小红书（微服务架构）》已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17..., 点击查看项目介绍；演示地址：http://116.62.199.48:7070/
《从零手撸：前后端分离博客项目（全栈开发）》 2期已完结,演示链接：http://116.62.199.48/;
专栏阅读地址：https://www.quanxiaoha.com/column

1. 我的私密学习小圈子，从0到1手撸企业实战项目~
2. 为什么大厂都禁用 SET 存储用户？Redis避坑指南
3. 我司用了 6 年的 Redis 分布式限流器，可以说是非常厉害了！
4. SpringBoot 中常用的工具类库及其使用示例（完整版）

最近面试BAT，整理一份面试资料《Java面试BATJ通关手册》，覆盖了Java核心技术、JVM、Java并发、SSM、微服务、数据库、数据结构等等。
获取方式：点“在看”，关注公众号并回复 Java 领取，更多内容陆续奉上。
PS：因公众号平台更改了推送规则，如果不想错过内容，记得读完点一下“在看”，加个“星标”，这样每次新文章推送才会第一时间出现在你的订阅列表里。
点“在看”支持小哈呀，谢谢啦

AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

告别扫描文档处理烦恼：ScanTailor Advanced的智能文档优化解决方案

ScanTailor Advanced是一款专业的扫描文档后期处理工具，专为解决老旧文档数字化中的各种问题而设计。通过智能内容识别、批量处理和多线程优化，它能将倾斜、模糊、杂乱的扫描文档转化为整洁的电子文件，显著提升文档数字化效率。## 文档数字化的常见痛点与解决方案### 页面歪斜校正：智能算法自动修正传统扫描文档经常出现页面歪斜问题，手动调整每页耗时耗力。ScanTailor Adv

AI Agent技术社区

SeedVR2终极指南：如何用单步扩散模型实现专业级视频修复

还在为老旧视频的模糊画质而烦恼吗？面对抖动严重的监控录像或褪色的家庭影像，你是否曾希望有一种简单高效的修复方案？SeedVR2正是为解决这些痛点而生的一站式视频修复工具。作为字节跳动推出的先进视频修复模型，它能够在单步推理中实现专业级的视频质量提升，彻底改变了传统视频修复的工作流程。## 核心价值：为什么选择SeedVR2进行视频修复？**传统视频修复的三大瓶颈**：1. **计算成本高

AI Agent技术社区

终极指南：如何用Python自动化工具告别大麦抢票焦虑，轻松获取心仪演出门票

还记得那些让你心跳加速的抢票时刻吗？热门演唱会开票瞬间，你手忙脚乱地刷新页面，却眼睁睁看着"立即购买"按钮变灰，票在几秒内售罄。这种"拼手速"的抢票时代已经过去，现在有了基于Python开发的大麦自动抢票工具，让你告别手速焦虑，轻松获取周杰伦、五月天、周深等热门演出的门票。## 🔥 你的抢票痛点，我们都有解决方案### 场景一：热门演唱会一票难求"周杰伦演唱会开票3秒售罄，我连页面都没