SpringBoot日志框架使用详解

几种常见的日志级别由低到高分为：TRACE < DEBUG < INFO < WARN < ERROR < FATAL 。如何理解这个日志级别呢？很简单，如果项目中的日志级别设置为INFO ，那么比它更低级别的日志信息 就看不到了，即是TRACE 、DEBUG日志将会不显示。

常见的日志框架有 log4j 、 logback 、 log4j2 。

• log4j 这个日志框架显示是耳熟能详了，在Spring开发中是经常使用，但是据说log4j官方已经不再更新了，而且在性能上比logback 、log4j2差了很多。
• logback 是由log4j创始人设计的另外一个开源日志框架，logback相比之于log4j性能提升了10以上， 初始化内存加载也更小了。作为的Spring Boot默认的日志框架肯定是有着不小的优势。
• log4j2 晚于 logback 推出，官网介绍性能比 logback 高，坊间流传，log4j2在很多思想理念上都是照抄logback，因此即便log4j2是Apache官方项目，Spring等许多框架项目没有将它纳入主流。

原则上需要使用logback，需要添加以下依赖，但是既然是默认的日志框架，当然不用重新引入依赖了。

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

使用方式

private final Logger logger = LoggerFactory.getLogger(DemoApplicationTests.class);

上面是基本的使用方式，lombok简化了输出日志的操作。

@Slf4j
class DemoApplicationTests {@Testpublic void test(){log.debug("输出DEBUG日志.......");}
}

如何定制日志级别？

Spring Boot中默认的日志级别是INFO，但是可以自己定制日志级别，还支持 package 级别的日志级别调整，配置如下：

logging.level.root=DEBUG
logging.level.com.example.demo=INFO

日志如何输出到文件？

注意：官方文档说这两个属性不能同时配置，否则不生效，因此只需要配置一个即可。

1. logging.file.path：指定日志文件的路径
2. logging.file.name：日志的文件名，默认为spring.log

指定输出的文件为当前项目路径的 logs 文件下，默认生成的日志文件为 spring.log ，如下：

logging.file.path=./logs

如何定制日志格式？

1. logging.pattern.console ：控制台的输出格式
2. logging.pattern.file ：日志文件的输出格式

例如配置如下：

logging.pattern.console==%d{yyyy/MM/dd-HH:mm:ss} [%thread] %-5level %logger- %msg%n
logging.pattern.file=%d{yyyy/MM/dd-HH:mm} [%thread] %-5level %logger- %msg%n

上面的配置编码的含义如下：

%d{HH:mm:ss.SSS} —— 日志输出时间
%thread   ——   输出日志的进程名字，这在Web应用以及异步任务处理中很有用
%-5level  ——   日志级别，并且使用5个字符靠左对齐
%logger   ——   日志输出者的名字
%msg      ——   日志消息
%n        ——   平台的换行符

如何自定义日志配置？

Spring Boot官方文档指出，根据不同的日志系统，可以按照如下的日志配置文件名就能够被正确加 载，如下：

1. Logback ：logback-spring.xml, logback-spring.groovy, logback.xml, logback.groovy
2. Log4j ：log4j-spring.properties, log4j-spring.xml, log4j.properties, log4j.xml
3. Log4j2 ：log4j2-spring.xml, log4j2.xml
4. JDK (Java Util Logging) ：logging.properties

SpringBoot官方推荐优先使用带有-spring的文件名作为你的日志配置。因此只需要在 src/resources 文件夹下创建 logback-spring.xml 即可，配置文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="60 seconds" debug="false"><!-- 定义日志存放目录 --><property name="logPath" value="logs"/><!-- 日志输出的格式--><property name="PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t-%L] %-5level %logger{36} %L %M - %msg%xEx%n"/><contextName>logback</contextName><!--输出到控制台 ConsoleAppender--><appender name="consoleLog" class="ch.qos.logback.core.ConsoleAppender"><!--展示格式 layout--><layout class="ch.qos.logback.classic.PatternLayout"><pattern>${PATTERN}</pattern></layout><!--过滤器，只有过滤到指定级别的日志信息才会输出，如果level为ERROR，那么控制台只会输出ERROR日志--><!-- <filter class="ch.qos.logback.classic.filter.ThresholdFilter">--><!-- <level>ERROR</level>--><!-- </filter>--></appender><!--正常的日志文件，输出到文件中--><appender name="fileDEBUGLog" class="ch.qos.logback.core.rolling.RollingFileAppender"><!--如果只是想要 Info 级别的日志，只是过滤 info 还是会输出 Error 日志，因为 Error 的级别高，所以我们使用下面的策略，可以避免输出 Error 的日志--><filter class="ch.qos.logback.classic.filter.LevelFilter"><!--过滤 Error--><level>Error</level><!--匹配到就禁止--><onMatch>DENY</onMatch><!--没有匹配到就允许--><onMismatch>ACCEPT</onMismatch></filter><!--日志名称，如果没有File 属性，那么只会使用FileNamePattern的文件路径规则如果同时有<File>和<FileNamePattern>，那么当天日志是<File>，明天会自动把今天的日志改名为今天的日期。即，<File> 的日志都是当天的。--><File>${logPath}/log_demo.log</File><!--滚动策略，按照时间滚动 TimeBasedRollingPolicy--><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><!--文件路径,定义了日志的切分方式——把每一天的日志归档到一个文件中,以防止日志填满整个磁盘空间--><FileNamePattern>${logPath}/log_demo_%d{yyyy-MM-dd}.log</FileNamePattern><!--只保留最近90天的日志--><maxHistory>90</maxHistory><!--用来指定日志文件的上限大小，那么到了这个值，就会删除旧的日志--><!--<totalSizeCap>1GB</totalSizeCap>--></rollingPolicy><!--日志输出编码格式化--><encoder><charset>UTF-8</charset><pattern>${PATTERN}</pattern></encoder></appender><!--输出ERROR日志到指定的文件中--><appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender"><!--如果只是想要 Error 级别的日志，那么需要过滤一下，默认是 info 级别的，ThresholdFilter--><filter class="ch.qos.logback.classic.filter.ThresholdFilter"><level>Error</level></filter><!--日志名称，如果没有File 属性，那么只会使用FileNamePattern的文件路径规则如果同时有<File>和<FileNamePattern>，那么当天日志是<File>，明天会自动把今天的日志改名为今天的日期。即，<File> 的日志都是当天的。--><File>${logPath}/error.log</File><!--滚动策略，按照时间滚动 TimeBasedRollingPolicy--><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><!--文件路径,定义了日志的切分方式——把每一天的日志归档到一个文件中,以防止日志填满整个磁盘空间--><FileNamePattern>${logPath}/error_%d{yyyy-MM-dd}.log</FileNamePattern><!--只保留最近90天的日志--><maxHistory>90</maxHistory><!--用来指定日志文件的上限大小，那么到了这个值，就会删除旧的日志--><!--<totalSizeCap>1GB</totalSizeCap>--></rollingPolicy><!--日志输出编码格式化--><encoder><charset>UTF-8</charset><pattern>${PATTERN}</pattern></encoder></appender><!--指定最基础的日志输出级别--><root level="DEBUG"><!--appender将会添加到这个loger--><appender-ref ref="consoleLog"/><appender-ref ref="fileDEBUGLog"/><appender-ref ref="fileErrorLog"/></root><!-- 定义指定package的日志级别--><logger name="org.springframework" level="DEBUG"></logger><logger name="org.mybatis" level="DEBUG"></logger><logger name="java.sql.Connection" level="DEBUG"></logger><logger name="java.sql.Statement" level="DEBUG"></logger><logger name="java.sql.PreparedStatement" level="DEBUG"></logger><logger name="io.lettuce.*" level="INFO"></logger><logger name="io.netty.*" level="ERROR"></logger><logger name="com.rabbitmq.*" level="DEBUG"></logger><logger name="org.springframework.amqp.*" level="DEBUG"></logger><logger name="org.springframework.scheduling.*" level="DEBUG"></logger><!--定义com.xxx..xx..xx包下的日志信息不上传，直接输出到fileDEBUGLog和fileErrorLog这个两个appender中，日志级别为DEBUG--><logger name="com.xxx.xxx.xx" additivity="false" level="DEBUG"><appender-ref ref="fileDEBUGLog"/><appender-ref ref="fileErrorLog"/></logger>
</configuration>

当然，如果就不想用Spring Boot推荐的名字，想自己定制也行，只需要在配置文件中指定配置文件名 即可，如下：

logging.config=classpath:logging-config.xml