SpringBoot整合日志功能（slf4j+logback）详解

日志门面就像饭店的服务员，而日志框架就像是后厨的厨师。对于顾客这个应用来说，我到饭店点菜，我只需要告诉服务员我要一盘番茄炒鸡蛋即可，我不关心他后厨的所有事情。因为虽然主厨从把这道菜称之为「番茄炒蛋」的厨师换成了把这道菜称之为「西红柿炒鸡蛋」的厨师。但是，顾客不需要关心，他只要下达「番茄炒蛋」的命令给到服务员，由服务员再去翻译给厨师就可以了。

所以，对于一个了解了「番茄炒蛋」的多种叫法的服务员来说，无论后厨如何换厨师，他都能准确的帮用户下单。

同理，对于一个设计的全面、完善的日志门面来说，他也应该是无缝兼容了多种日志框架的。所以，底层框架的更换，日志门面几乎不需要改动。

以上，就是日志门面的一个比较重要的好处------解耦。

二、简介

Spring使用commons-logging作为内部日志，但底层日志实现是开放的。可对接其他日志框架。spring5及以后 commons-logging被spring直接自己写了。
支持 jul，log4j2,logback。SpringBoot 提供了默认的控制台输出配置，也可以配置输出为文件。
logback是默认使用的。
虽然日志框架很多 ，但是我们不用担心，使用 SpringBoot 的默认配置就能工作的很好。

SpringBoot怎么把日志默认配置好的？

每个starter场景，都会导入一个核心场景spring-boot-starter
核心场景引入了日志的所用功能spring-boot-starter-logging
默认使用了slf4j + logback 组合作为默认底层日志
日志是系统一启动就要用，而xxxAutoConfiguration是系统启动好了以后放好的组件，后来用的。
日志是利用监听器机制 配置好的。ApplicationListener。
日志所有的配置都可以通过修改配置文件实现。以logging开始的所有配置。

三、日志格式

bash 复制代码

2023-03-31T13:56:17.511+08:00  INFO 4944 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2023-03-31T13:56:17.511+08:00  INFO 4944 --- [           main] o.apache.catalina.core.StandardEngine    : Starting Servlet engine: [Apache Tomcat/10.1.7]

默认输出格式：

时间和日期：毫秒级精度
日志级别：ERROR, WARN, INFO, DEBUG, or TRACE.
进程 ID
---：消息分割符
线程名：使用[]包含
Logger 名：通常是产生日志的类名
消息：日志记录的内容

注意： logback 没有FATAL级别，对应的是ERROR

默认值：参照：spring-boot包additional-spring-configuration-metadata.json文件

默认输出格式值：%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}

在application.properties可修改为：

bash 复制代码

%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [%thread] %logger{15} ===> %msg%n

启动项目发现日志变成我们修改的样子了。

四、记录日志

4.1 使用日志工厂

java 复制代码

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 HelloController {

    Logger log = LoggerFactory.getLogger(getClass());

    @GetMapping("/hello")
    public String hello(){
        log.info("方法进来了...");
        return "Hello,Spring Boot 3!";
    }

}

4.2 使用Lombok的@Slf4j注解

java 复制代码

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello(){
        log.info("方法进来了...");
        return "Hello,Spring Boot 3!";
    }

}

五、日志级别

5.1 日志级别介绍

由低到高：ALL,TRACE, DEBUG, INFO, WARN, ERROR,FATAL,OFF；
- 只会打印指定级别及以上级别的日志
- ALL：打印所有日志
- TRACE：追踪框架详细流程日志，一般不使用
- DEBUG：开发调试细节日志
- INFO：关键、感兴趣信息日志
- WARN：警告但不是错误的信息日志，比如：版本过时
- ERROR：业务错误日志，比如出现各种异常
- FATAL：致命错误日志，比如jvm系统崩溃
- OFF：关闭所有日志记录
不指定级别的所有类，都使用root指定的级别作为默认级别
SpringBoot日志默认级别是 INFO

也就是说，如果你配置文件没有配置日志级别，那么默认级别是info，打印的也是info顺序后面的日志级别，包括info、warn、error、fatal、off等。

5.2 配置日志级别

application.properties中配置：

bash 复制代码

logging.level.root = debug

这样配置代表以后debug及以后级别的日志都可以打印。

5.3 指定某个包下的类使用某个级别

bash 复制代码

logging.level.com.atguigu.controller=debug

代表只有com.atguigu.controller包使用debug级别，其余都使用默认info级别。

5.4 占位符打印

java 复制代码

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello(String a, String b){
        log.info("info日志：参数a:{} 参数b:{}", a, b);
        return "Hello,Spring Boot 3!";
    }

}

六、日志分组

有这么一种场景，比如我的包很多，这些包都想设置debug级别，那么配置如下：

java 复制代码

logging.level.com.atguigu.controller=debug
logging.level.com.atguigu.service=debug
logging.level.com.atguigu.dao=debug
logging.level.com.atguigu.entity=debug
logging.level.com.atguigu.common=debug
...

这样当包有很多的时候，写起来很麻烦！！！那么有什么办法呢？没错，就是分组。

比如我把这些包分成一个组，组名叫abc，配置如下：

java 复制代码

logging.group.abc=com.atguigu.controller,com.atguigu.service,com.atguigu.dao,com.atguigu.entity,com.atguigu.common
logging.level.abc=debug

这样不就简便很多了吗？

七、文件输出

SpringBoot 默认只把日志写在控制台，如果想额外记录到文件，可以在application.properties中添加logging.file.name or logging.file.path配置项。

|-------------------|-------------------|----------|-----------------------|
| logging.file.name | logging.file.path | 示例 | 效果 |
| 未指定 | 未指定 | | 仅控制台输出 |
| 指定 | 未指定 | my.log | 写入指定文件。可以加路径 |
| 未指定 | 指定 | /var/log | 写入指定目录，文件名为spring.log |
| 指定 | 指定 | | 以logging.file.name为准 |

例：将日志打印在D盘的/logs/my.log中

java 复制代码

logging.file.name=D:/logs/my.log

八、文件归档与滚动切割

比如我们将项目的日志打印到D:\\my.log中，那么时间短还行，如果持续一年，我们的日志文件将会非常大，打开都会崩的状态。

归档：每天的日志单独存到一个文档中。

切割：每个文件10MB，超过大小切割成另外一个文件。

每天的日志应该独立分割出来存档。如果使用logback（SpringBoot 默认整合），可以通过application.properties/yaml文件指定日志滚动规则。
如果是其他日志系统，需要自行配置（添加log4j2.xml或log4j2-spring.xml）
支持的滚动规则设置如下

|------------------------------------------------------|-----------------------------------------------------------|
| 配置项 | 描述 |
| logging.logback.rollingpolicy.file-name-pattern | 日志存档的文件名格式（默认值：${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz） |
| logging.logback.rollingpolicy.clean-history-on-start | 应用启动时是否清除以前存档（默认值：false） |
| logging.logback.rollingpolicy.max-file-size | 存档前，每个日志文件的最大大小（默认值：10MB） |
| logging.logback.rollingpolicy.total-size-cap | 日志文件被删除之前，可以容纳的最大大小（默认值：0B）。设置1GB则磁盘存储超过 1GB 日志后就会删除旧日志文件 |
| logging.logback.rollingpolicy.max-history | 日志文件保存的最大天数(默认值：7). |

例：

java 复制代码

logging.file.name=D:\logs\my.log
# LOG_FILE：代表我们配置的日志文件名，如my.log
# yyyy-MM-dd：年月日
# %i：代表当天第几个文件
logging.logback.rollingpolicy.file-name-pattern=${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz
# 只要my.log日志文件大于10MB就会触发日志归档，将当前日志文件压缩为my.log.2019-01-01.1.gz
logging.logback.rollingpolicy.max-file-size=10MB

九、自定义配置

通常我们配置 application.properties 就够了。当然也可以自定义。比如：

|-------------------------|---------------------------------------------------------------------------|
| 日志系统 | 自定义 |
| Logback | logback-spring.xml, logback-spring.groovy, logback.xml, or logback.groovy |
| Log4j2 | log4j2-spring.xml or log4j2.xml |
| JDK (Java Util Logging) | logging.properties |

如果可能，我们建议您在日志配置中使用-spring 变量（例如，logback-spring.xml 而不是 logback.xml）。如果您使用标准配置文件，spring 无法完全控制日志初始化。

最佳实战：自己要写配置，配置文件名加上 xx-spring.xml

十、切换日志组合

XML 复制代码

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

哪怕你切换log4j2，你也不用改任何代码和配置，这就是日志门面的好处。