Spring Boot 教程：日志

【注】本文译自： [https://www.tutorialspoint.com/spring_boot/spring_boot_logging.htm](https://www.tutorialspoint.com/spring_boot/spring_boot_logging.htm)

Spring Boot 使用 Apache Commons logging 作为内部日志。Spring Boot 缺省配置提供对于 Java Util Logging, Log4j2 和 Logback 的支持。这样，我们可以配置控制台或者文件日志。

如果使用 Spring Boot 启动器，Logback 会提供很好的日志支持。此外，Logback 对 Common Logging、Util Logging、Log4J 和 SLF4J 的支持也不错。

缺省 Spring Boot 的日志格式如下图所示：


提供了以下信息：

默认日志消息会打印到控制台窗口。缺少情况下，“INFO”, “ERROR” 和 “WARN” 日志消息会在日志文件中打印。

如果要允许 debug 级别的日志，用命令行启动应用时加上 debug 标识，如下所示：

java –jar demo.jar --debug

也可以在 application.properties 中加入调试模式，如下所示：

debug = true

默认情况下，所有的日志都会不打印到控制台窗口而不是在文件中。如果你要将日志打印到文件中，需要在 application.properties 文件中设置 logging.file 或 logging.path 属性。

可以如下所示设置日志文件路径，注意日志文件名为 spring.log。

logging.path = /var/tmp/

你也可以设置自己的日志文件名，如下所示：

logging.file = /var/tmp/mylog.log

注意：文件在达到 10 MB 时将自动转储。

Spring Boot 支持所有的日志级别，如 “TRACE”, “DEBUG”, “INFO”, “WARN”, “ERROR”, “FATAL”, “OFF”。可以在 application.properties 文件中定义根日志，如下所示：

logging.level.root = WARN

注意： Logback 不支持 “FATAL” 级别的日志，它会被映射为 “ERROR” 级别的日志。

Logback 支持基于 XML 的配置来处理 Spring Boot 日志配置。日志配置细节在 logback.xml 配置文件中。logback.xml 文件应当位于 classpath 路径下。

可以在 Logback.xml 文件中配置根级别日志，如下所示：

<?xml version = "1.0" encoding = "UTF-8"?><configuration>   <root level = "INFO">   </root></configuration>

    可以在 Logback.xml 文件中配置 控制台 appender，如下所示：

<?xml version = "1.0" encoding = "UTF-8"?><configuration>   <appender name = "STDOUT" class = "ch.qos.logback.core.ConsoleAppender"></appender>   <root level = "INFO">      <appender-ref ref = "STDOUT"/>   </root></configuration>

    可以在 Logback.xml 配置文件 appender，如下所示。注意需要在 file appender 中指定日志文件路径。

<?xml version = "1.0" encoding = "UTF-8"?><configuration>   <appender name = "FILE" class = "ch.qos.logback.core.FileAppender">      <File>/var/tmp/mylog.log</File>   </appender>      <root level = "INFO">      <appender-ref ref = "FILE"/>   </root></configuration>

    可以在 logback.xml 文件中定义日志范式，也可以定义在控制台或者文件中的日志范式集，如下所示：

<pattern>[%d{yyyy-MM-dd'T'HH:mm:ss.sss'Z'}] [%C] [%t] [%L] [%-5p] %m%n</pattern>

    完整的 logback.xml 文件如下，需要放在 class path 路径下：

<?xml version = "1.0" encoding = "UTF-8"?><configuration>   <appender name = "STDOUT" class = "ch.qos.logback.core.ConsoleAppender">      <encoder>         <pattern>[%d{yyyy-MM-dd'T'HH:mm:ss.sss'Z'}] [%C] [%t] [%L] [%-5p] %m%n</pattern>      </encoder>   </appender>      <appender name = "FILE" class = "ch.qos.logback.core.FileAppender">      <File>/var/tmp/mylog.log</File>      <encoder>         <pattern>[%d{yyyy-MM-dd'T'HH:mm:ss.sss'Z'}] [%C] [%t] [%L] [%-5p] %m%n</pattern>      </encoder>   </appender>      <root level = "INFO">      <appender-ref ref = "FILE"/>      <appender-ref ref = "STDOUT"/>   </root></configuration>

    下面的代码展示了如何在主类文件中加上 slf4j logger：

package com.tutorialspoint.demo;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplicationpublic class DemoApplication {   private static final Logger logger = LoggerFactory.getLogger(DemoApplication.class);      public static void main(String[] args) {      logger.info("this is a info message");      logger.warn("this is a warn message");      logger.error("this is a error message");      SpringApplication.run(DemoApplication.class, args);   }}

    控制台窗口输出如下所示：


日志文件输出如下所示：