深入理解 SpringBoot 日志框架：从入门到高级应用——（七）SpringBoot日志配置

SpringBoot 官方文档：https://docs.spring.io/spring-boot/docs/2.7.12/reference/htmlsingle

SpringBoot 底层依赖

Spring Boot 对所有内部日志记录使用 Commons Logging，但使底层日志实现保持为打开状态。 为 Java Util Logging、Log4J2 和 Logback 提供了默认配置。默认情况下，Logback、 Java Util Logging、Commons Logging、Log4J 或 SLF4J 都能正常工作。而 Spring Boot 中使用了 SLF4J + Logback 作为默认的日志框架，因此我们不需要更改日志记录依赖项，Spring 引导默认值就可以正常工作。SpringBoot 底层日志依赖关系如图所示：

在 spring-boot-starter 依赖下有 spring-boot-starter-logging 日志依赖，后续的 logback-core、logback-core 依赖即使用 Logback 记录日志，而 jul-to-slf4j、log4j-to-slf4j 即将 JUL 和 Log4j 日志框架转为 Slf4j 日志框架，即所谓的桥接器。

日志组

我们也可以将相关的日志记录器组合在一起，以便可以同时配置它们。例如，可能经常更改所有与 Tomcat 相关的记录器的日志记录级别，我们可以在 YAML 配置文件中将与 Tomcat 相关的包添加成一个组，之后再对组设置日志输出的级别：

logging:
  group:
    # 自定义组名，设置当前组中所包含的包
    tomcat: org.apache.catalina,org.apache.coyote,org.apache.tomcat

SpringBoot 包括以下预定义的日志记录组：

日志级别

在SpringBoot 中，日志的级别默认分为7个级别：TRACE（跟踪）、DEBUG（调试）、 INFO（信息）、WARN（警告）、ERROR（错误）、FATAL（致命）、OFF（关闭）。

我们可以根据需要设置不同的日志级别，在 SpringBoot 的 YAML 配置文件中对所有的日志框架输出的日志级别进行设置。我们可以对全局或者指定分组以及指定包分别设置日志的输出级别：

logging:
  level:
    # 设置root根节点级别，即整体应用日志级别，输出 WARN 级别及以上的日志信息
    root: warn
    # 为对应组设置日志级别，输出 TRACE 级别及以上的日志信息
    tomcat: trace
    # 为对包设置日志级别，输出 DEBUG 级别及以上的日志信息
    com.example.logging: debug

日志格式

在配置文件中设置日志的输出格式：

# 设置日志输出格式
logging:
  pattern:
    console: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level [%logger{36}] - %msg%n"

SpringBoot 的默认日志输出格式如下：

输出格式如下：

常用占位符如下：

以上是一些常用的占位符，可以根据需要自行组合使用。

Spring Boot使用Logback作为默认的日志框架，可以通过在application.properties或application.yml文件中设置日志级别和日志输出格式。

以下是application.yml中常用的日志配置选项：

# 设置日志输出文件的路径和名称
logging:
  file:
    name: myapp.log
    path: /var/log/myapp/

以上示例中，logging.level 设置日志级别，logging.pattern设置日志输出格式，logging.file.name和logging.file.path设置日志输出文件的路径和名称。需要注意的是，如果同时设置了logging.file和logging.path选项，则logging.file选项将覆盖logging.path选项。

文件输出

SpringBoot 默认会将日志输出到控制台，并不会写入日志文件。 如果我们需要将日志写入日志文件，则需要在 application.yml 中进行相关配置：

# 设置日志输出文件的路径和名称
logging:
  file:
    name: myapp.log
    path: /var/log/myapp/

Tip

logging.file.name 和 logging.file.path 设置日志输出文件的路径和名称。需要注意的是，如果同时设置了logging.file 和 logging.path 选项，则 logging.file 选项将覆盖 logging.path 选项。

自定义日志配置

在 SpringBoot 中，我们除了使用默认的配置外，还可以通过在 src/main/resources 目录下添加自定义日志配置文件来自定义日志输出的格式、级别、以及日志文件的位置等信息。

方式1：限定文件名

通过 SpringBoot 指定限定名的方式：项目启动时会自动进行加载：

使用该方式，Spring 官方推荐建议您我们使用 *-spring.xml 的限定名，这样可以交由 SpringBoot 控制日志，我们也可以对其中的配置进行更加细化的设置：

<springProfile name="dev">
    <!-- 配置项在 spring.profiles.active=dev 的环境下启动 -->
</springProfile>
<springProfile name="!dev">
    <!-- 配置项在 spring.profiles.active!=dev 的环境下启动 -->
</springProfile>

方式2：自定义文件名

以下是自定义日志文件名的步骤：

1. 在 src/main/resources 目录下创建一个名为 logback-dev.xml 的文件，这个文件名称可以自定义。
2. 在配置文件中指定日志配置文件：

logging.config=classpath:logging-config.xml

日志框架切换

Logback To Log4j

原理图如右图：

方式1

我们需要将对应 logback 框架的依赖进行移除，添加 slf4j-log4j12 的适配器即可。

1. 移除日志框架 logback 的依赖：

   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-web</artifactId>
     <exclusions>
       <exclusion>
         <groupId>ch.qos.logback</groupId>
         <artifactId>logback-classic</artifactId>
       </exclusion>
     </exclusions>
   </dependency>
   

2. 引入适配器 slf4j-log4j12 和 log4j 的依赖

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-log4j12</artifactId>
   </dependency>
   

方式2

1. 移除 spring-boot-starter-logging 依赖：

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

2. 添加 spring-boot-starter-log4j 依赖：

   <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-log4j -->
   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-log4j</artifactId>
     <version>1.3.8.RELEASE</version>
   </dependency>
   

添加 log4j.properties 配置文件

log4j 不提供默认配置，因为输出到控制台或者文件系统在某些环境中可能是被禁止的。所以需要在 resources 目录下手动添加配置文件，配置文件名为 log4j.properties。

Logback To Log4j2

同理，我们需要排除原有的依赖，替换新的依赖即可：

1. 移除依赖

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

2. 添加依赖

   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-log4j2</artifactId>
   </dependency>
   

3. 需要异步

   <!--开启异步时需要导入依赖-->
   <dependency>
     <groupId>com.lmax</groupId>
     <artifactId>disruptor</artifactId>
     <version>3.4.2</version>
   </dependency>
   

添加配置文件

有关部分请查看文章：深入理解 SpringBoot 日志框架：从入门到高级应用——（五）Log4j2配置文件详解文章来源地址https://uudwc.com/A/knmB