SpringBoot日志框架如何使用

更新时间：2021年01月26日 10:37:35 作者：Mark-Chou

这篇文章主要介绍了SpringBoot日志框架如何使用，帮助大家更好的理解和使用springboot日志框架，感兴趣的朋友可以了解下

不管是开发过程中调试还是线上问题的定位追踪，日志都发挥着及其重要的作用。平时，我们会用System.out.println()打印一些信息到控制台，我们可以使用该语句输出日志，但是System.out会增加资源的消耗，所以最好使用日志框架打印日志信息。

Java中的日志框架有JCL、Jboss-logging、slf4j、logback、log4j、log4j2等等，其中JCL、Jboss-logging、slf4j属于日志门面（日志的抽象），logback、log4j、log4j2是日志框架的具体实现。阿里巴巴开发规范强制要求使用日志的门面而不要直接使用日志系统的API。

【强制】应用中不可直接使用日志系统（Log4j、Logback）中的 API，而应依赖使用日志框架（SLF4J、JCL--Jakarta Commons Logging）中的 API，使用门面模式的日志框架，有利于维护和各个类的日志处理方式统一。

日志门面不是日志解决方案，它只服务于各种各样的日志系统，这就允许最终用户在部署应用时可以随意使用其所希望的日志系统。也就是说如果开始使用slf4j+logback记录日志，则项目会按logback的风格打印日志，后期如果我们想更改为log4j风格的输出，则只需将logback替换为log4j即可，不需改变项目中的任何代码。

slf4j+logback也是SpringBoot中默认整合的日志框架。

如何使用

public class LoggerService {
  private static final Logger logger = LoggerFactory.getLogger(LoggerService.class);

  public void printLog() {
      logger.trace("trace日志……");
      logger.debug("debug日志……");
      logger.info("info日志……");
      logger.warn("warn日志……");
      logger.error("error日志……");
  }
}

使用LoggerFactory生成Logger对象，然后调用Logger对象的相应日志级别的方法打印即可。另外，在输出日志时，字符串的拼接要使用占位符替换不要使用append等方法。

【强制】在日志输出时，字符串变量之间的拼接使用占位符的方式。说明：因为 String 字符串的拼接会使用 StringBuilder 的 append()方式，有一定的性能损耗。使用占位符仅是替换动作，可以有效提升性能。正例：logger.debug("Processing trade with id: {} and symbol: {}", id, symbol);

上述代码的运行效果：

2020-12-28 13:32:40.751 INFO 16016 --- [nio-8080-exec-2] c.c.e.e.service.LoggerService           : info日志……
2020-12-28 13:32:40.751 WARN 16016 --- [nio-8080-exec-2] c.c.e.e.service.LoggerService           : warn日志……
2020-12-28 13:32:40.751 ERROR 16016 --- [nio-8080-exec-2] c.c.e.e.service.LoggerService           : error日志……

从运行效果可以看出，SpringBoot默认的日志级别（trace < debug < info < warn < error）是info。

指定配置

SpringBoot日志的默认配置在org\springframework\boot\spring-boot\2.4.1\spring-boot-2.4.1.jar!\org\springframework\boot\logging\logback\defaults.xml文件中，内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<!--
Default logback configuration provided for import
-->

<included>
  <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
  <conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
  <conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />

  <property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}}){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}}"/>
  <property name="CONSOLE_LOG_CHARSET" value="${CONSOLE_LOG_CHARSET:-default}"/>
  <property name="FILE_LOG_PATTERN" value="${FILE_LOG_PATTERN:-%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39} : %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
  <property name="FILE_LOG_CHARSET" value="${FILE_LOG_CHARSET:-default}"/>

  <logger name="org.apache.catalina.startup.DigesterFactory" level="ERROR"/>
  <logger name="org.apache.catalina.util.LifecycleBase" level="ERROR"/>
  <logger name="org.apache.coyote.http11.Http11NioProtocol" level="WARN"/>
  <logger name="org.apache.sshd.common.util.SecurityUtils" level="WARN"/>
  <logger name="org.apache.tomcat.util.net.NioSelectorPool" level="WARN"/>
  <logger name="org.eclipse.jetty.util.component.AbstractLifeCycle" level="ERROR"/>
  <logger name="org.hibernate.validator.internal.util.Version" level="WARN"/>
  <logger name="org.springframework.boot.actuate.endpoint.jmx" level="WARN"/>
</included>

里面定义了默认的日志输出格式， org\springframework\boot\spring-boot\2.4.1\spring-boot-2.4.1.jar!\org\springframework\boot\logging\logback\base.xml 文件中定义了日志默认级别。如果想要使用自定义的配置，在类路径下放上日志框架自己对应的配置文件即可，如logback对应logback-spring.xml或logback.xml，log4j2对应log4j2-spring.xml或log4j2.xml，这样Springboot便不在使用默认配置。

SpringBoot 官方建议在日志配置中使用 -spring 的配置方式(例如，使用 logback-spring.xml 而不是 logback.xml)。如果使用标准配置位置，Spring 无法完全控制日志初始化。

另外官方文档中有明确提到，JUL(ava Util Logging) 在 FATJAR 场景下存在一些已知的类加载问题，所以要尽量避免在 FATJAR 场景下使用 JUL。

使用这种命名方式日志框架就不会直接加载日志的配置，而改由SpringBoot加载，同时使用SpringBoot的高级Profile功能指定某段配置只在某个环境下生效。

<springProfile name="dev">
 <!-- 激活dev下的配置 -->
</springProfile>

<springProfile name="!production">
 <!-- 激活非production下的配置 -->
</springProfile>

示例

<appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">  
 <layout class="ch.qos.logback.classic.PatternLayout">
 <!-- 该输出格式只在dev下生效 -->
 <springProfile name="dev">
  <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} ----> [%thread] ---> %-5level    %logger{50} - %msg%n</pattern>   
 </springProfile>     
 </layout> 
</appender>

logback配置详解

logback完整配置如下

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">  
<!-- 日志文件的地址，windows和Linux下都要写绝对地址 -->
<property name="LOG_HOME" value="/home" />
<!-- 日志输出格式：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度,%msg：日志消息，%n是换行符 -->
<property name="LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n" />

<!--控制台输出 -->
<appender name="CONSOLE_OUT" class="ch.qos.logback.core.ConsoleAppender">
  <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
    <!-- 输出格式，直接引用上面定义的property -->
    <pattern>${LOG_PATTERN}</pattern>
    </encoder>
</appender>

<!--文件输出， 每天生成日志文件 -->
<appender name="FILE_OUT" class="ch.qos.logback.core.rolling.RollingFileAppender">
  <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    <!--日志文件名-->
    <FileNamePattern>${LOG_HOME}/XXX.log.%d{yyyy-MM-dd}.log</FileNamePattern>
    <!--日志文件保留天数，15天是阿里巴巴开发规范中的最低要求-->
    <MaxHistory>15</MaxHistory>
  </rollingPolicy>
  <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
    <!--输出格式，同上-->
    <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  </encoder>
  <!--日志文件最大的大小-->
  <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
  <MaxFileSize>10MB</MaxFileSize>
  </triggeringPolicy>
</appender>

<!-- myibatis日志配置 -->
<logger name="com.apache.ibatis" level="TRACE"/>
<logger name="java.sql.Connection" level="DEBUG"/>
<logger name="java.sql.Statement" level="DEBUG"/>
<logger name="java.sql.PreparedStatement" level="DEBUG"/>

<!-- 日志输出级别 -->
<root level="DEBUG">
  <appender-ref ref="CONSOLE_OUT" />
  <appender-ref ref="FILE_OUT"/>
</root>

</configuration>

更换日志框架

SpringBoot中的日志实现默认是logback，假如我们要更换其他日志实现，假如要更换为Log4j2，该怎么做呢？

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

<!-- 引入新实现 -->
<dependency>    
    <groupId>org.springframework.boot</groupId>    
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

总结一下就是分为两步：

移除原日志的实现，根据新使用的日志实现不同需移除的项目也有所不同，如要使用log4j则需移除以下依赖。

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

引入新实现的依赖。

log4j需引入，这是一个适配层的包，其自动依赖了log4j。

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

log4j2需引入。

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

以上就是SpringBoot日志框架如何使用的详细内容，更多关于SpringBoot日志框架的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Java服务器端跨域问题解决方案
这篇文章主要介绍了java服务器端跨域问题解决方案,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-01-01
java实现简单贪吃蛇小游戏
这篇文章主要为大家详细介绍了java实现简单贪吃蛇小游戏，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-05-05
Spring超详细讲解AOP面向切面
面向对象编程是一种编程方式，此编程方式的落地需要使用“类”和 “对象”来实现，所以，面向对象编程其实就是对 “类”和“对象” 的使用，面向切面编程，简单的说，就是动态地将代码切入到类的指定方法、指定位置上的编程思想就是面向切面的编程
2022-10-10
Mybatis中传递多个参数的4种方法总结
这篇文章主要给大家介绍了关于Mybatis中传递多个参数的4种方法，并且介绍了关于使用Mapper接口时参数传递方式，文中通过示例代码介绍的非常详细，需要的朋友可以参考借鉴，下面随着小编来一起学习学习吧。
2018-04-04
Java synchronize底层实现原理及优化
这篇文章主要介绍了Java synchronize底层实现原理及优化,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-03-03
Spring Boot的listener(监听器)简单使用实例详解
监听器（Listener）的注册方法和 Servlet 一样，有两种方式：代码注册或者注解注册。接下来通过本文给大家介绍Spring Boot的listener(监听器)简单使用,需要的朋友可以参考下
2017-04-04
Idea打War包流程图文教程
这篇文章主要给大家介绍了关于Idea打War包流程的相关资料,IDEA导出war包的方式与MyEclipse有一点不同,文中通过图文介绍的非常详细,需要的朋友可以参考下
2023-08-08
SpringBoot整合Redis的哨兵模式的实现
Redis提供了哨兵模式来处理主从切换和故障转移,本文主要介绍了SpringBoot整合Redis的哨兵模式的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-08-08
Java编程中的equals方法使用全解
这篇文章主要介绍了Java编程中的equals方法使用全解,是Java入门学习中的基础知识,需要的朋友可以参考下
2015-10-10
如何解决springboot读取配置文件的中文乱码问题
本篇文章主要介绍了如何解决springboot读取配置文件的中文乱码问题，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看
2018-05-05

SpringBoot日志框架如何使用

如何使用

指定配置

logback配置详解

更换日志框架

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具