Logback 配置

阅读量：5285 次

发布时间：2019-06-14

本文共 6165 字，大约阅读时间需要 20 分钟。

写在前面的话：

作为《Java程序员修炼之道》博文的第一个主题Logging，我计划中按照如下三篇来写：

Logback的简单介绍和配置

在Java代码中如何使用SLF4J来写日志以及写日志的要点

作为一个程序员，在日常工作中如何分析和挖掘Log。

1. 缘起

写代码中的日志是一个除了用代码实现功能之外最基础最基础的一个技能了，是一个必须掌握的技能。但是目前为止，关于如何日志的文章和书籍还是不多。

1.1 写日志的必要性

碰到QA提的一个bug的时候，我见识过两种方式的答复：a)请给我重现步骤和重现数据；b）把当时的日志给我。答复前者的，一般需要花很多时间去找问题出现在那里，如果是别人开发的模块的话，花费的时间更多。答复后者的，一般能很快的找到出问题的点，然后就可以开始进入修复的流程。

从概念上来说：日志是一个可运行的、可维护的软件的基础组成部分；通过日志，我们可以了解软件系统在运行中的实时状态，历史状态和异常状态等。一个没有良好日志的软件是所有人的噩梦。

如果你不想给自己找麻烦，你还是把日志好好写写。

1.2 为什么选Logback？

原因有俩：

我最近几年用的都是Logback

在前几天Log4j 2.0出来之前，logback的Logger用得比较爽

不过不管是Logback、Log4j还是别的什么Log框架，后继文章里面的关于写Log的一些技巧和建议都是适用的。

2. 如何配置Logback

下面会简单介绍一下Logback的配置，适用于开始配置和开始入门，适用于一般情况下的使用，如果想了解更多的信息，建议看看Logback的官方文档，写得很不错的。

2.1 Logback简单介绍

简单来说就是Log4j 1流行了，发现有一些问题是无法解决的，于是又出来了Logback，在Log4j的基础上提升了性能，提高了功能等等。不过前几天有出来了Log4j 2，据说是相对于Logbak来说又提升了性能提高了功能。

2.2 关于SLF4J和Logback

SLF4J(slf4j.org)又称Simple Logging Facade for Java，是一个通用的logging接口，它试图一统Logging框架的天下，兼容了(Log4j 1, java.util.logging和Jakarta Commons Logging）这三个最流行的Logging框架。Logback就是SLF4J的默认实现。

2.3 依赖包导入

下文以Logback 1.1.2及slf4j1.7.6版本为例子。一般情况下，你按照我下面说的就可以了，如果不行的话，你可以去翻翻英文的文档：。

2.3.1 一般程序

Maven版

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

<artifactId>logback-classic</artifactId>

</dependency>

非Maven版

把下载下来之后，在其根目录下有logback-core-1.1.2.jar和logback-classic-1.1.2.jar这俩个Jar，在logback-examples\lib下有slf4j-api-1.7.6.jar这个jar,把这三个Jar添加到你的代码包路径中。

2.3.2 非独立运行程序

如果你做的是一个Lib或者API，那么你就不应该依赖于具体的slf4j实现。所以你对logback的依赖应该是在运行测试代码的时候，具体实现方式如下文所示：

Maven版

</dependency>

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

<artifactId>logback-classic</artifactId>

</dependency>

当然了你是要把版本信息放在pom.xml中的<dependencies>还是<dependencyManagement>里面就你自己决定吧。

非Maven版

在发布的时候不要把只有Logback才用到jar打包进你的发布程序里面。（如果觉得绕口再多读两遍）

2.4 与遗留Logging框架兼容

目前行业除了Logback之外，广泛使用的还有其他四种Logging框架：

Log4j 1 ()

Log4j 2 ()

java.util.logging ()

Apache commons Logging ()

Log4j 2因为是刚出来的，目前SLF4J对其的兼容性还未知，对于其他的三种框架，SLF4J都提供了兼容性的支持。下面介绍了如何让Logbak兼容这些框架，另外，也可以阅读官方说明：

2.4.1 兼容Log4j 1和Apache Commons Logging

SLF4J对于Log4J 1和Apache commons Logging的支持方式是提供了实现Log4j和Apache commons Logging接口的SLF4J实现。使用方式是

去取对Log4J和Apache commons Logging的Jar包的引用

引入SLF4J的对应接口的实现包。

2.4.1.1 移除引用

如果你的系统是直接的使用了Log4j或者Apache commons Logging框架的话，你可以直接把对他们的引用去掉就可以了。如果是你所引用的第三方包里面引用了Log4j或者Apache commons Logging，可以使用<exclusions>标签去掉对他们的引用，如下所示：

<groupId>org.springframework.ldap</groupId>

<artifactId>spring-ldap-core</artifactId>

<artifactId>commons-logging</artifactId>

<groupId>commons-logging</groupId>

</exclusion>

</exclusions>

</dependency>

如何找到哪些第三方包引用了Log4j或者Apache commons Logging呢？有俩个方法：

使用 mvn dependency:tree 命令，如下图所示，可以看出需要在org.springframework.ldap:spring-ldap-core中排除掉对Apache commons Logging的引用。

第二种方式是使用Eclipse的m2e Maven插件。如下图所示，打开pom.xml文件后，选择Dependency Hierarchy标签，然后在Filter中输入logging或者log4j进行过滤，在左侧的Dependency Hierarchy中使用右键菜单就可以自动过滤了。