深入浅“粗”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文件中，内容如下：

里面定义了默认的日志输出格式，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功能指定某段配置只在某个环境下生效。

示例

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

logback配置详解

logback完整配置如下

   
  
  
  
  

  
  
    
      
      ${LOG_PATTERN}
     
  

  
  
    
      
      ${LOG_HOME}/XXX.log.%d{yyyy-MM-dd}.log
      
      15
    
    
      
      %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n
    
    
    
    10MB
    
  

 
 
 
 
 

 
 
   
   
 

更换日志框架

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

     
  org.springframework.boot     
  spring-boot-starter-web     
   
    
      
      org.springframework.boot 
      spring-boot-starter-logging        
         
   
  


     
  org.springframework.boot     
  spring-boot-starter-log4j2 

总结一下就是分为两步：

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

  org.springframework.boot
  spring-boot-starter-web
  
    
      logback-classic
      ch.qos.logback
    
    
      log4j-over-slf4j
      org.slf4j
    
  

2. 引入新实现的依赖。

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

   
     org.slf4j
     slf4j-log4j12
   
   

   log4j2需引入。

        
     org.springframework.boot     
     spring-boot-starter-log4j2