一起来学SpringBoot | 第三篇：SpringBoot日志配置

• **本文作者：**唐亚峰

• 本文链接：http://blog.battcn.com/2018/04/23/springboot/v2-config-logs/
• **版权声明：**本博客所有文章除特别声明外，均采用CC BY-NC-SA 3.0许可协议。转载请注明出处！

---

强烈推荐

分享一个大神的人工智能教程。零基础！通俗易懂！风趣幽默！还带黄段子！希望你也加入到人工智能的队伍中来！http://www.captainbed.net

SpringBoot是为了简化Spring应用的创建、运行、调试、部署等一系列问题而诞生的产物，自动装配的特性让我们可以更好的关注业务本身而不是外部的XML配置，我们只需遵循规范，引入相关的依赖就可以轻易的搭建出一个 WEB 工程

##更多干货：
SpringBoot系列博客目录，含1.5.X版本和2.X版本

Spring Boot内部采用的是Commons Logging进行日志记录，但在底层为**Java Util Logging、Log4J2、Logback**等日志框架提供了默认配置 。

Java 虽然有很多可用的日志框架，但请不要担心，一般来说，使用SpringBoot默认的Logback就可以了。

日志格式

SpringBoot的默认输出的日志格式如下：

2014-03-05 10:57:51.112  INFO 45469 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet Engine: Apache Tomcat/7.0.52
2014-03-05 10:57:51.253  INFO 45469 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2014-03-05 10:57:51.253  INFO 45469 --- [ost-startStop-1] o.s.web.context.ContextLoader            : Root WebApplicationContext: initialization completed in 1358 ms
2014-03-05 10:57:51.698  INFO 45469 --- [ost-startStop-1] o.s.b.c.e.ServletRegistrationBean        : Mapping servlet: 'dispatcherServlet' to [/]
2014-03-05 10:57:51.702  INFO 45469 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean  : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]

输出如下元素：

Logback是没有FATAL级别的日志，它将被映射到ERROR

• 时间日期：精确到毫秒,可以用于排序
• 日志级别：ERROR、WARN、INFO、DEBUG、TRACE
• 进程ID
• 分隔符：采用---来标识日志开始部分
• 线程名：方括号括起来（可能会截断控制台输出）
• Logger名：通常使用源代码的类名
• 日志内容：我们输出的消息

日志输出

SpringBoot默认为我们输出的日志级别为INFO、WARN、ERROR，如需要输出更多日志的时候，可以通过以下方式开启

• 命令模式配置：java -jar app.jar --debug=true， 这种命令会被SpringBoot解析，且优先级最高
• 资源文件配置：application.properties配置debug=true即可。该配置只对 嵌入式容器、Spring、Hibernate生效，我们自己的项目想要输出DEBUG需要额外配置（配置规则：logging.level.<logger-name>=<level>）

日志输出级别配置

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

#比如 mybatis sql日志
logging.level.org.mybatis = INFO
logging.level.mapper所在的包 = DEBUG

日志输出格式配置

• **logging.pattern.console：**定义输出到控制台的格式（不支持JDK Logger）
• **logging.pattern.file：**定义输出到文件的格式（不支持JDK Logger）

颜色编码

如果终端支持ANSI，默认情况下会给日志上个色，提高可读性，可以在配置文件中设置spring.output.ansi.enabled来改变默认值

• **ALWAYS：**启用ANSI颜色的输出。
• **DETECT：**尝试检测ANSI着色功能是否可用。
• **NEVER：**禁用ANSI颜色的输出。

编码对照表

Level	Color
WARN	Yellow
FATAL、ERROR	Red
INFO、DEBUG、TRACE	Green

如果想修改日志默认色值，可以通过使用%clr关键字转换。比如想使文本变为黄色%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){yellow}。目前支持的颜色有（blue、cyan、faint、green、magenta、red、yellow）

文件保存

默认情况下，SpringBoot仅将日志输出到控制台，不会写入到日志文件中去。如果除了控制台输出之外还想写日志文件，则需要在application.properties设置logging.file或logging.path属性。

• logging.file：将日志写入到指定的文件中，默认为相对路径，可以设置成绝对路径
• logging.path：将名为spring.log写入到指定的文件夹中，如（/var/log）

日志文件在达到10MB时进行切割，产生一个新的日志文件（如：spring.1.log、spring.2.log），新的日志依旧输出到spring.log中去，默认情况下会记录ERROR、WARN、INFO级别消息。

• **logging.file.max-size：**限制日志文件大小
• **logging.file.max-history：**限制日志保留天数

自定义日志配置

由于日志在ApplicationContext之前就初始化好了，所以SpringBoot为我们提供了logging.config属性，方便我们配置自定义日志文件。默认情况它会根据日志的依赖自动加载。

Logging System	Customization
JDK (Java Util Logging)	logging.properties
Log4j2、ERROR	log4j2-spring.xml 或 log4j2.xml
Logback	logback-spring.xml、logback-spring.groovy、logback.xml、logback.groovy

Logback扩展配置

该扩展配置仅适用logback-spring.xml或者设置logging.config属性的文件，因为logback.xml加载过早，因此无法获取SpringBoot的一些扩展属性

使用扩展属性springProfile与springProperty让你的logback-spring.xml配置显得更有逼格，当别人还在苦苦挣扎弄logback-{profile}.xml的时候 你一个文件就搞定了…

springProfile

<springProfile>标签使我们让配置文件更加灵活，它可以选择性的包含或排除部分配置。

<springProfile name="dev">
    <!-- 开发环境时激活 -->
</springProfile>

<springProfile name="dev,test">
    <!-- 开发，测试的时候激活-->
</springProfile>

<springProfile name="!prod">
    <!-- 当 "生产" 环境时，该配置不激活-->
</springProfile>

案例

<!-- 开发环境日志级别为DEBUG/并且开发环境不写日志文件 -->
<springProfile name="dev">
    <root level="DEBUG">
        <appender-ref ref="STDOUT"/>
    </root>
</springProfile>

<!-- 测试环境日志级别为INFO/并且记录日志文件 -->
<springProfile name="test">
    <root level="INFO">
        <appender-ref ref="FILE"/>
        <appender-ref ref="STDOUT"/>
    </root>
</springProfile>

springProperty

<springProperty>标签可以让我们在Logback中使用 Spring Environment 中的属性。如果想在logback-spring.xml中回读application.properties配置的值时，这是一个非常好的解决方案

<!-- 读取 spring.application.name 属性来生成日志文件名
    scope：作用域
    name：在 logback-spring.xml 使用的键
    source：application.properties 文件中的键
    defaultValue：默认值
 -->
<springProperty scope="context" name="logName" source="spring.application.name" defaultValue="myapp.log"/>

<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>logs/${logName}.log</file>
</appender>

总结

更多细节请参考官方文档：https://docs.spring.io/spring-boot/docs/2.0.1.RELEASE/reference/htmlsingle/#boot-features-custom-log-configuration

目前很多大佬都写过关于**SpringBoot**的教程了，如有雷同，请多多包涵，本教程基于最新的spring-boot-starter-parent：2.0.1.RELEASE编写，包括新版本的特性都会一起介绍…

## 说点什么

springboot技术交流群：681513531

个人博客：https://winterchen.com

• **本文作者：**唐亚峰
• 本文链接：http://blog.battcn.com/2018/04/23/springboot/v2-config-logs/
• **版权声明：**本博客所有文章除特别声明外，均采用CC BY-NC-SA 3.0许可协议。转载请注明出处！