默认情况下，如果您使用了 Starter，则使用 Logback 进行日志记录。还包括合适的 Logback 路由，以确保在使用 Java Util Logging、Commons Logging、Log4J 或 SLF4J 的依赖库都能正常工作。

    提示

    Spring Boot 默认日志输出类似于以下示例：

    输出以下项：

    • 日期和时间：毫秒精度，易于排序。
    • 日志级别：、WARN、INFO、DEBUG 或 TRACE。
    • 进程 ID。
    • 一个 --- 分隔符，用于区分实际日志内容的开始。
    • 日志记录器名称：这通常是源类名称（通常为缩写）。
    • 日志内容。

    注意

    Logback 没有 FATAL 级别。该级别映射到 ERROR。

    26.2、控制台输出

    默认日志配置会在写入时将消息回显到控制台。默认情况下，会记录 ERROR、WARN 和 INFO 级别的日志。您还可以通过使用 --debug 标志启动应用程序来启用调试模式。

    1. $ java -jar myapp.jar --debug

    注意

    您还可以在 application.properties 中指定 debug=true。

    启用调试模式后，核心日志记录器（内嵌容器、Hibernate 和 Spring Boot）将被配置为输出更多日志信息。启用调试模式不会将应用程序配置为使用 DEBUG 级别记录所有日志内容。

    或者，您可以通过使用 --trace 标志（或在 application.properties 中的设置 trace=true）启动应用程序来启用跟踪模式。这样做可以为选择的核心日志记录器（内嵌容器、Hibernate 模式生成和整个 Spring 组合）启用日志追踪。

    26.2.1、着色输出

    如果您的终端支持 ANSI，则可以使用颜色输出来提高可读性。您可以将 spring.output.ansi.enabled 设置为受支持的值以覆盖自动检测。

    可使用 ％clr 转换字配置颜色编码。最简单形式是，转换器根据日志级别对输出进行着色，如下所示：

    1. %clr(%5p)

    下表描述日志级别与颜色的映射关系：

    或者，您可以通过将其作为转换选项指定应使用的颜色或样式。例如，要将文本变为黄色，请使用以下设置：

    支持以下颜色和样式：

    • blue
    • cyan
    • faint
    • green
    • magenta
    • red
    • yellow

    下表展示了如何与 logging.* 属性一起使用：

    表 26.1、Logging 属性

    日志文件在达到 10MB 时会轮转，并且与控制台输出一样，默认情况下会记录 ERROR、WARN 和 INFO 级别的内容。可以使用 logging.file.max-size 属性更改大小限制。除非已设置 logging.file.max-history 属性，否则以前轮转的文件将无限期归档。

    注意

    日志记录系统在应用程序生命周期的早期开始初始化。因此，通过 @PropertySource 注解加载的属性文件中是找不到日志属性的。

    提示

    26.4、日志等级

    所有受支持的日志记录系统都可以使用 来设置 Spring Environment 中的记录器等级（例如，在 application.properties 中）。其中 level 是 TRACE、DEBUG、INFO、WARN、ERROR、FATAL 和 OFF 其中之一。可以使用 logging.level.root 配置 root 记录器。

    以下示例展示了 application.properties 中默认的日志记录设置：

    1. logging.level.root=WARN
    2. logging.level.org.springframework.web=DEBUG
    3. logging.level.org.hibernate=ERROR

    26.5、日志组

    将相关记录器组合在一起以便可以同时配置，这通常很有用。例如，您可以更改所有 Tomcat 相关记录器的日志记录级别，但您无法轻松记住顶层的包名。

    为了解决这个问题，Spring Boot 允许您在 Spring Environment 中定义日志记录组。例如，以下通过将 tomcat 组添加到 application.properties 来定义 tomcat 组：

      定义后，您可以使用一行配置来更改组中所有记录器的级别：

      Spring Boot 包含以下预定义的日志记录组，可以直接使用：

      可以通过在 classpath 中引入适合的库来激活各种日志记录系统，并且可以通过在 classpath 的根目录中或在以下 Spring Environment 属性指定的位置提供合适的配置文件来进一步自定义：logging.config。

      您可以使用 org.springframework.boot.logging.LoggingSystem 系统属性强制 Spring Boot 使用特定的日志记录系统。该值应该是一个实现了 LoggingSystem 的类的完全限定类名。您还可以使用 none 值完全禁用 Spring Boot 的日志记录配置。

      注意

      由于日志记录在创建 ApplicationContext 之前初始化，因此无法在 Spring @Configuration 文件中控制来自 @PropertySources 的日志记录。更改日志记录系统或完全禁用它的唯一方法是通过系统属性设置。

      根据您的日志记录系统，将加载以下文件：

      如果可能，我们建议您使用 -spring 的形式来配置日志记录（比如 logback-spring.xml 而不是 logback.xml）。如果使用标准的配置位置，Spring 无法完全控制日志初始化。

      警告

      Java Util Logging 存在已知的类加载问题，这些问题在以可执行 jar 运行时会触发。如果可能的话，我们建议您在使用可执行 jar 方式运行时避免使用它。

      为了进行自定义，部分其他属性会从 Spring Environment 传输到 System 属性，如下表所述：

      所有受支持的日志记录系统在解析其配置文件时都可以参考系统属性。有关示例，请参阅 spring-boot.jar 中的默认配置：

      提示

      提示

      您可以通过仅覆盖 LOG_LEVEL_PATTERN（或带 Logback 的 logging.pattern.level）将 MDC 和其他特别的内容添加到日志行。例如，如果使用 logging.pattern.level=user:%X{user} %5p，则默认日志格式包含 user MDC 项（如果存在），如下所示:2015-09-30 12:30:04.031 user:someone INFO 22174 --- [ nio-8080-exec-0] demo.Controller Handling authenticated request

      26.7、Logback 扩展

      Spring Boot 包含许多 Logback 扩展，可用于进行高级配置。您可以在 logback-spring.xml 配置文件中使用这些扩展。

      注意

      由于标准的 logback.xml 配置文件加载过早，因此无法在其中使用扩展。您需要使用 logback-spring.xml 或定义 logging.config 属性。

      警告

      扩展不能与 Logback 的配置扫描一起使用。如果尝试这样做，更改配置文件会导致发生类似以下错误日志：

      1. ERROR in ch.qos.logback.core.joran.spi.Interpreter@4:71 - no applicable action for [springProperty], current ElementPath is [[configuration][springProperty]]
      2. ERROR in ch.qos.logback.core.joran.spi.Interpreter@4:71 - no applicable action for [springProfile], current ElementPath is [[configuration][springProfile]]

      26.7.1、特定 Profile 配置

      <springProfile> 标签允许您根据激活的 Spring profile 选择性地包含或排除配置部分。在 <configuration> 元素中的任何位置都支持配置 profile。使用 name 属性指定哪个 proifle 接受配置。<springProfile> 标记可以包含简单的 proifle 名称（例如 staging）或 profile 表达式。profile 表达式允许表达更复杂的 profile 逻辑，例如 production & (eu-central | eu-west)。有关详细信息，请查阅。以下清单展示了三个示例 profile：

      1. <springProfile name="staging">
      2.     <!-- configuration to be enabled when the "staging" profile is active -->
      3. </springProfile>
      5. <springProfile name="dev | staging">
      6.     <!-- configuration to be enabled when the "dev" or "staging" profiles are active -->
      7. </springProfile>
      9. <springProfile name="!production">
      10. </springProfile>

      使用 <springProperty> 标记可以让您暴露 Spring 环境（Environment）中的属性，以便在 Logback 中使用。如果在 Logback 配置中访问来自 application.properties 文件的值，这样做很有用。标签的工作方式与 Logback 的标准 <property> 标签类似。但是，您可以指定属性（来自 Environment）的 source，而不是指定直接的 value。如果需要将属性存储在 local 范围以外的其他位置，则可以使用 scope 属性。如果需要回退值（如果未在 Environment 中设置该属性），则可以使用 defaultValue 属性。以下示例展示了如何暴露属性以便在 Logback 中使用：

      注意