Spring Boot从零入门4_日志记录及其配置详解

本文属于原创，转载注明出处，欢迎关注微信小程序小白AI博客 微信公众号小白AI或者网站 https://xiaobaiai.net

[TOC]

0 前言

本篇文章主要对Spring Boot的日志记录进行详细讲解，包括流行的开源日志标准接口以及流行的日志记录器在Spring Boot中是如何配置及应用的，以及在生产环境中，我们所需要的配置是否都能够满足？

1 名词术语

相关背景知识我们还是需要了解的，有助于对正文内容的理解。

名词术语	释义
Apache Common Logging	Apache下开源项目，commons-logging的目的是为“所有的Java日志实现”提供一个统一的接口，使项目与日志实现工具解耦；commons-logging和log4j都是Apache下的开源项目。commons-logging的目的是为“所有的Java日志实现”提供一个统一的接口，使项目与日志实现工具解耦，它自身的日志功能比较弱（只有一个简单的 SimpleLog），所以一般不会单独使用它。
Log4j / Log4j 2	Apache下的开源项目，Log4j的功能非常强大，是目前最主流的java日志工具。Log4j 2.0 引入了新的插件系统、对 properties 的支持、对基于 JSON 配置的支持和配置的自动化重载。相比之前Log4j 的1.x 版本有了很大的性能提升。它支持很多已有的日志框架，包括 SLF4J、Commons Logging、Apache Flum、Log4j 1.x，并提供了新的程序员 API。
Java Util Logging	Java 的原生日志记录基础组件
Logback	是一个日志框架，旨在取代Log4j，Log4j的改良版本，比Log4j拥有更多的特性，同时也带来很大性能提升。不过性能上没有Log4j 2好。
SLF4J	跟Apache Common Logging一样，也是一套接口，现在流行的日志框架和接口组合就是Commons Logging加Log4j 、SLF4J加Logback、slf4j + log4j2
Mockito	Mockito是一个通用的模拟框架，可用于单元测试，尤其是考虑到依赖注入而设计的类。Mockito也可以用来测试Spring Controller，但不是针对性的支持。
MockMVC	MockMVC是Spring框架的配套产品，有助于测试Spring Controllers。MockMVC更加具体，与Mockito相比，通用性可能要差得多，不过对于测试Spring MVC 中Restful API是比较好的。

2 日志记录

Spring Boot使用Apache Commons Logging接口记录所有内部日志记录。Spring Boot的默认配置对Java Util Logging，Log4j2和Logback日志记录器的使用都提供了支持。如果你使用的是Spring Boot Starters，默认使用的Logback就为日志记录提供很好的支持。 下面我们分几部分对如何做日志记录以及配置不同的日志记录器做说明，在Spring Boot中只需要通过一些简单的配置即可支持各种日志记录。

2.1 默认零配置记录日志

默认启动日志记录是由spring-boot-starter-logging依赖项决定的，并且它是自动配置的，该自动配置可根据提供的配置启用任何受支持的日志记录器（Java Util Logging，Log4J2和Logback），虽然我们不提供任何日志相关的配置，但是我们仍然能够在控制台上看到日志打印，这是因为Spring boot使用了Logback提供了默认的日志记录支持。但是我们上一篇文章里为啥没有看到pom.xml文件里有导入spring-boot-starter-logging这个依赖项呢？

Spring Boot的内部日志记录是使用Apache Commons Logging接口编写的，因此它是唯一的强制性依赖项。在Spring boot1.x的时候我们还需要手动导入，但是到了Spring boot2.x，它是间接导入的，即我们依赖了spring-boot-starter-web这个依赖项时，它就依赖了spring-boot-starter-logging，这个时候就导入了日志记录功能。从STS的pom.xml文件依赖展开就可以看到：

因此，Spring boot自动配置提供使用Logback的默认日志记录，并且这些配置文件中提供了默认日志记录的参数配置。从Spring Boot的日志记录源码就可以看到（ https://github.com/spring-pro... ） 。

2.1.1 使用日志记录器打印日志

在应用程序代码中添加日志记录语句，我们使用SLF4J接口中的org.slf4j.Logger和org.slf4j.LoggerFactory。它提供了许多有用的日志记录方法，也使日志记录实现与应用程序相分离。

注意：日志接口是很多，这里我们选择了SLF4J API。还有apache.logging/java.util.logging等

// 使用Log4j2则使用apache logging接口
// import org.apache.logging.log4j.LogManager;
// import org.apache.logging.log4j.Logger; 

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
 
@SpringBootApplication
public class Application 
{
    private static final Logger LOGGER=LoggerFactory.getLogger(Test02HelloworldApplication.class);
 
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
         
        LOGGER.info("简单的日志记录测试 :  {}  + {}  =  {}", 1, 2, 3);
    }
}

控制台打印如下：

2019-10-29 21:37:39.818  INFO 16244 --- [           main] c.xiaobaiai.Test02HelloworldApplication  : 简单的日志记录测试 :  1  + 2  =  3

2.1.2 日志记录器的日记级别

Logback支持设置ERROR，WARN，INFO，DEBUG、TRACE或OFF作为日志记录级别，按日志抑制优先级从高到低。默认情况下，日志记录级别设置为INFO。这意味着DEBUG和TRACE消息不可见。

要启用DEBUG或TRACE日志记录级别，我们可以在application.properties文件中设置日志记录级别。另外，我们也可以在启动应用程序时在命令行上传递--debug或--trace参数。

# In application.properties file
# 方法一: 该属性置为true的时候，核心Logger（包含嵌入式容器、hibernate、spring）会输出更多内容，但是你自己应用的日志并不会输出DEBUG级别的日志
debug=true
# 方法二：将日志记录级别应用于特定的软件包。
logging.level.com.xiaobaiai=DEBUG
logging.level.org.springframework=ERROR
logging.level.root=DEBUG

# In Console
$ java -jar target/xx-app-0.0.1-SNAPSHOT.jar --trace

注意： 如果使用不同的日志级别多次定义了软件包的日志级别，则将使用最低级别。TRACE最低，ERROR最高。

2.1.3 日志记录器的日志记录格式

默认的日志记录格式在Spring Boot日志记录器Logback源码文件default.xml中可以看到：

日志最后输出如下信息：

• 日期和时间：毫秒精度，便于排序
• 日志级别：ERROR, WARN, INFO, DEBUG, or TRACE
• 进程ID
• ---分隔符用于区分实际日志消息的开始
• 线程名称：用方括号括起来（对于控制台输出可能会被截断）
• 名称：这通常是类的名称（通常缩写）
• 最后就是日志信息体

要定义日志最后的输出格式，使用logging.pattern.console和logging.pattern.file属性。

# Logging pattern for the console
# 不支持JDK Logger
logging.pattern.console= %d{yyyy-MM-dd HH:mm:ss} - %logger{36} - %msg%n
  
# Logging pattern for file
# 不支持JDK Logger
logging.pattern.file= %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%

2.1.4 将日志输出到文件

默认情况下，Spring boot日志仅记录到控制台。如果要启用文件日志记录，则可以使用简单的属性logging.file或logging.path轻松实现。

# 输出到指定路径，默认文件名为spring.log
logging.file.path=C:\\Work\\sts4\\test_02_helloworld\\logs
# 文件名设置，使用了该项配置，则会覆盖path设置，直接在工程当前目录下生成日志
logging.file.name=logfilename.log
# 路径与文件名结合（该配置项已被遗弃）
logging.file=${logging.file.path}/log.log
# 输出到文件最大内容限制大小，达到最大后，会截断
# 默认是10M，而且该设置项只对默认的Logback有效，单位GB/MB/KB等
logging.file.max-size = 10MB

2.1.5 日志彩色输出

如果你的终端支持ANSI，设置彩色输出会让日志更具可读性。通过在application.properties中设置spring.output.ansi.enabled参数来支持。

# NEVER：禁用ANSI-colored输出（默认项）
# DETECT：会检查终端是否支持ANSI，是的话就采用彩色输出（推荐项）
# ALWAYS：总是使用ANSI-colored格式输出，若终端不支持的时候，会有很多干扰信息，不推荐使用
spring.output.ansi.enabled=DETECT

2.1.6 自定义日志配置

根据不同的日志系统，你可以按如下规则组织配置文件名，就能被正确加载：

• Logback：logback-spring.xml, logback-spring.groovy, logback.xml, logback.groovy，logback-spring-xxx.xml
• Log4j：log4j-spring.properties, log4j-spring.xml, log4j.properties, log4j.xml
• Log4j2：log4j2-spring.xml, log4j2.xml
• JDK (Java Util Logging)：logging.properties

Spring Boot官方推荐优先使用带有-spring的文件名作为你的日志配置（如使用logback-spring.xml，而不是logback.xml），命名为logback-spring.xml的日志配置文件，Spring boot可以为它添加一些Spring boot特有的配置项。

上面是默认的命名规则，并且放在src/main/resources下面即可。

如果你即想完全掌控日志配置，但又不想用logback.xml作为Logback配置的名字，可以在application.properties配置文件里面通过logging.config属性指定自定义的名字：

logging.config=classpath:logging-config.xml

这里简单讲述Logback的一个自定义配置，具体的可以参见官方文档http://logback.qos.ch/manual/configuration.html

配置文件主要实现的功能有：

• 对控制台和日志保存到文件进行了配置
• 对控制台的日志级别进行了控制
• 对输出到文件进行了分割处理设置，包括单日志文件大小，所有日志文件大小限制，以及日志保存的天数
• 对输出到文件的日志命名方式进行了设置
• 对指定包的日志输出级别进行了控制

    
    xiaobaiai

    
    

    
    
        
        
            INFO
        
        
            %d{yyyy-MM-dd HH:mm:ss.SSS} %contextName %magenta([%thread]) %highlight(%-5level) %logger{36}.%M - %msg%n
        
    

    
    
        
        ${log.path}/log_newest.log
        
            
            %d{yyyy-MM-dd HH:mm:ss.SSS} %magenta([%thread]) %highlight(%-5level) %logger{36}.%M - %msg%n
        
        
        
            
                ${log.path}/log_%d{yyyy-MM-dd}_%i.log
            
            3KB
            
            10
            
            100MB
        
    

    
    
    
        
        
    

    
    
        
    

2.2 Log4j2 记录日志

2.2.1 引入Log4j2

默认日志记录使用了Logback，首先我们需要在pom.xml中去掉Logback，引入Log4j2。

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

 

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

2.2.2 添加log4j2配置文件

与Logback类似，在资源文件夹下（resources）添加如下形式的配置文件，都可以被扫描到：

• log4j2-spring.xml
• log4j2.xml

配置文件设置与Logback大同小异：

    
        %d{yyyy-MM-dd'T'HH:mm:ss.SSSZ} %p %m%n
        c:/temp
    
    
        
            
        
  
        
            
            
                
            
            
        
  
    
    
        
            
            
        
    

2.3 内嵌WEB服务器日志设置

这里就不展开了，到了实际使用的时候，再来详细了解。

#tomcat
server.tomcat.basedir=C:/temp/logs
server.tomcat.accesslog.enabled=true
server.tomcat.accesslog.pattern=%t %a "%r" %s (%D ms)
logging.level.org.apache.tomcat=DEBUG
logging.level.org.apache.catalina=DEBUG
 
#undertow
server.undertow.accesslog.directory=C:/temp/logs
server.undertow.accesslog.enabled=true
server.undertow.accesslog.pattern=%t %a "%r" %s (%D ms)
logging.level.io.undertow.server=DEBUG
logging.level.io.undertow.websockets=DEBUG 
 
#jetty
server.jetty.accesslog.filename=/var/log/jetty-access.log
server.jetty.accesslog.enabled=true
logging.level.org.eclipse.jetty=INFO
logging.level.org.eclipse.jetty.websocket=DEBUG

3 总结

本篇文章让我们对主流的日志接口Apache common logging和SLF4J有了个了解，Logback是Spring boot中默认配置的日志记录器，我们对如何在application.properties中配置日志相关配置做了详细说明，并对如何自定义Logback配置也作出了详细说明，最后介绍了如何切换日志记录器到Log4j2以及如何配置Log4j2给出了示例。扩展部分对内嵌WEB服务器的日志配置也给出了个简单的示例。总之，我们对Spring boot的日志这一块应该不会再陌生了。

4 参考文档

• http://commons.apache.org/pro...
• https://www.infoq.com/news/20...
• https://stackify.com/compare-...
• https://blog.souche.com/logba...
• https://howtodoinjava.com/spr...
• https://www.codingame.com/pla...
• https://howtodoinjava.com/spr...

本文属于原创，转载注明出处，欢迎关注CSDNfreeape或微信小程序小白AI博客 微信公众号小白AI或者网站 https://xiaobaiai.net