title: Springboot 系列（四）Spring Boot 日志框架

toc_number: false

date: 2019-01-15 22:02:02

url: springboot/springboot04-log

tags:

- Springboot

- Springboot2

- Logback

categories:

- Springboot

Spring 框架选择使用了 JCL 作为默认日志输出。而 Spring Boot 默认选择了 SLF4J 结合 LogBack。那我们在项目中该使用哪种日志框架呢？在对于不同的第三方 jar 使用了不同的日志框架的时候，我们该怎么处理呢？

日志对于应用程序的重要性不言而喻，不管是记录运行情况还是追踪线上问题，都离不开对日志的分析，在 Java 领域里存在着多种日志框架，如 JUL, Log4j, Log4j2, Commons Loggin, Slf4j, Logback 等。关于 Log4j, Log4j2 和 Slf4j 直接的故事这里不做介绍，有兴趣可以自行百度。

在开发的时候不应该直接使用日志实现类，应该使用日志的抽象层。具体参考 [SLF4J 官方](https://www.slf4j.org/manual.html)。

下图是 SLF4J 结合各种日志框架的官方示例，从图中可以清晰的看出 SLF4J API 永远作为日志的门面，直接应用与应用程序中。


同时 SLF4 官方给出了简单示例。

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

public class HelloWorld {

public static void main(String[] args) {

Logger logger = LoggerFactory.getLogger(HelloWorld.class);

logger.info("Hello World");

}

}

需要注意的是，要为系统导入 SLF4J 的 jar 和 日志框架的实现 jar. 由于每一个日志的实现框架都有自己的配置文件，所以在使用 SLF4 之后，配置文件还是要使用实现日志框架的配置文件。

一般情况下，在项目中存在着各种不同的第三方 jar ，且它们的日志选择也可能不尽相同，显然这样是不利于我们使用的，那么如果我们想为项目设置统一的日志框架该怎么办呢？

在 [SLF4J 官方](https://www.slf4j.org/legacy.html)，也给了我们参考的例子。

从图中我们得到一种统一日志框架使用的方式，可以使用一种和要替换的日志框架类完全一样的 jar 进行替换，这样不至于原来的第三方 jar 报错，而这个替换的 jar 其实使用了 SLF4J API. 这样项目中的日志就都可以通过 SLF4J API 结合自己选择的框架进行日志输出。

**统一日志框架使用步骤归纳如下**：

1. 排除系统中的其他日志框架。

2. 使用中间包替换要替换的日志框架。

3. 导入我们选择的 SLF4J 实现。

根据上面总结的要统一日志框架的使用，第一步要排除其他的日志框架，在 Spring Boot 的 Maven 依赖里可以清楚的看到 Spring Boot 排除了其他日志框架。

我们自行排除依赖时也只需要按照图中的方式就好了。

其实 Spring Boot 也是使用了 SLF4J+logback 的日志框架组合，查看 Spring Boot 项目的 Maven 依赖关系可以看到 Spring Boot 的核心启动器 spring-boot-starter 引入了 spring-boot-starter-logging.

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-logging</artifactId>

<version>2.1.1.RELEASE</version>

<scope>compile</scope>

</dependency>

而 spring-boot-starter-logging 的 Maven 依赖主要引入了 logback-classic (包含了日志框架 Logback 的实现)，log4j-to-slf4j (在 log4j 日志框架作者开发此框架的时候还没有想到使用日志抽象层进行开发，因此出现了 log4j 向 slf4j 转换的工具)，jul-to-slf4j ( Java 自带的日志框架转换为 slf4j).

<dependencies>

<dependency>

<groupId>ch.qos.logback</groupId>

<artifactId>logback-classic</artifactId>

<version>1.2.3</version>

<scope>compile</scope>

</dependency>

<dependency>

<groupId>org.apache.logging.log4j</groupId>

<artifactId>log4j-to-slf4j</artifactId>

<version>2.11.1</version>

<scope>compile</scope>

</dependency>

<dependency>

<groupId>org.slf4j</groupId>

<artifactId>jul-to-slf4j</artifactId>

<version>1.7.25</version>

<scope>compile</scope>

</dependency>

</dependencies>

从上面的分析，Spring Boot 对日志框架的使用已经是清晰明了了，我们使用 IDEA 工具查看 Maven 依赖关系，可以清晰的看到日志框架的引用。如果没有 IDEA 工具，也可以使用 Maven 命令查看依赖关系。

mvn dependency:tree

由此可见，Spring Boot 可以自动的适配日志框架，而且底层使用 **SLF4 + LogBack** 记录日志，如果我们自行引入其他框架，需要排除其日志框架。

从上面的分析，发现 Spring Boot 默认已经使用了 **SLF4J + LogBack** . 所以我们在不进行任何额外操作的情况下就可以使用 **SLF4J + Logback** 进行日志输出。

编写 Java 测试类进行测试。

import org.junit.Test;

import org.junit.runner.RunWith;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.springframework.boot.test.context.SpringBootTest;

import org.springframework.test.context.junit4.SpringRunner;

@RunWith(SpringRunner.class)

public class LogbackTest {

Logger logger = LoggerFactory.getLogger(getClass());

@Test

public void testLog() {

logger.trace("Trace 日志...");

logger.debug("Debug 日志...");

logger.info("Info 日志...");

logger.warn("Warn 日志...");

logger.error("Error 日志...");

}

}

已知日志级别从小到大为 trace < debug < info < warn < error . 运行得到输出如下。由此可见 ***Spring Boot 默认日志级别为 INFO***.

从上面的日志结合 Logback 日志格式可以知道 Spring Boot 默认日志格式是。

%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n

至于为什么 Spring Boot 的默认日志输出格式是这样？

我们可以在 Spring Boot 的源码里找到答案。

可以直接在配置文件编写日志相关配置。

关于日志的输出路径，可以使用 logging.file 或者 logging.path 进行定义，两者存在关系如下表。

| `logging.file` | `logging.path` | 例子 | 描述 |

| -------------- | -------------- | ---------- | ------------------------------------------------------------ |

| *（没有）* | *（没有）* | | 仅控制台记录。 |

| 具体文件 | *（没有）* | `my.log` | 写入指定的日志文件，名称可以是精确位置或相对于当前目录。 |

| *（没有）* | 具体目录 | `/var/log` | 写入`spring.log`指定的目录，名称可以是精确位置或相对于当前目录。 |

因为 Log4j 日志框架已经年久失修，原作者都觉得写的不好，所以下面演示替换日志框架为 Log4j2 的方式。根据[官网](https://docs.spring.io/spring-boot/docs/2.1.x/reference/html/using-boot-build-systems.html#using-boot-starter)我们 Log4j2 与 logging 需要二选一，因此修改 pom如下。

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-web</artifactId>

<exclusions>

<exclusion>

<artifactId>spring-boot-starter-logging</artifactId>

<groupId>org.springframework.boot</groupId>

</exclusion>

</exclusions>

</dependency>

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-log4j2</artifactId>

</dependency>

文章代码已经上传到 GitHub [Spring Boot 日志系统](https://github.com/niumoo/springboot/tree/master/springboot-logback)。