1.解决SLF4J报错

大家经常碰到,在自己的项目中使用了SLF4J,或者引入了某开源项目时,运行时会报如下的错误:

SLF4J: No SLF4J providers were found.
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See SLF4J Error Codes for further details.

检查自己的classpath,发现已经引入了slf4j-api-xx.jar了,这是为什么呢?其原因是,SLF4J本身不是一个日志库,而是一个日志库的抽象层,它必须依赖底层的日志库,看SLF4J官网上的这张图:


SLF4J: No SLF4J providers were found._slf4j

从图中可知,SLF4J必须和其他日志库配合才能正常运行。因此一般来说,需要将抽象层(例如slf4j-api-xx.jar)+中间层(例如slf4j-log4j12)+实现层(例如log4j)这三层都配置好才能保证SLF4J正常运行。

另外,有的日志库可以去掉中间层,例如slf4j-api和slf4j-simple就可以直接配合

2.SLF4J和slf4j-simple的配合使用

这种方式就是抽象层+实现层的组合。使用这种方式只需要以下两个jar包:

slf4j-api-1.8.0-beta0.jar
slf4j-simple-1.8.0-beta0.jar
并将这两个jar包加入classpath,或者使用maven:

<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-api</artifactId>
  <version>1.8.0-beta0</version>
</dependency>
 
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-simple</artifactId>
  <version>1.8.0-beta0</version>
</dependency>

写一段代码测试一下:

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");
    }
}

3.SLF4J和Log4j的配合使用

这种方式就是抽象层+中间层+实现层的组合,需要三个jar包:

  • slf4j-api-1.8.0-beta0.jar
  • slf4j-log4j12-1.8.0-beta0.jar
  • log4j-1.2.17.jar

其中抽象层和中间层的版本号是一致的,都是1.8.0-beta0,而log4j的版本号则要去Search/Browse/Explore上搜索,搜索版本是先搜索slf4j-log4j12-1.8.0-beta0.jar,然后看它的依赖项,查到其中log4j的版本号是1.2.17。

并将这三个jar包加入classpath,或者使用maven:

<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-api</artifactId>
  <version>1.8.0-beta0</version>
</dependency>
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.8.0-beta0</version>
</dependency>
<dependency>
  <groupId>log4j</groupId>
  <artifactId>log4j</artifactId>
  <version>1.2.17</version>
</dependency>

依然使用上面的代码测试,发现SLF4J的报错不存在了,但是出现了新的报错如下:

log4j:WARN No appenders could be found for logger (.HelloWorld).
log4j:WARN Please initialize the log4j system properly.
log4j:WARN See Frequently Asked Technical Questions for more info.

这说明SLF4J已经配置好了,但是Log4j的配置还有问题。

4.解决Log4j的报错

Log4j的这个报错也是非常常见的,在直接使用Log4j时也会出现,在
No appenders could be found for logger(log4j)?
此处详细介绍了如何解决这个错误,有两种方法来解决。
第一种,在main函数中加入一行代码:BasicConfigurator.configure();
经测试有效。但是这样的话源代码中就必须显式的加入Log4j的包,这样SLF4J失去了作为抽象层的抽象作用。
第二种,添加一个配置文件log4j.properties,内容如下(内容可以自定义):

# Set root logger level to DEBUG and its only appender to A1.
log4j.rootLogger=DEBUG, A1
 
# A1 is set to be a ConsoleAppender.
log4j.appender.A1=org.apache.log4j.ConsoleAppender
 
# A1 uses PatternLayout.
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%-4r [%t] %-5p %c %x - %m%n

将此文件放到classpath中。此外,关于log4j.properties的路径问题网上还有众多讨论。

5.小结

SLF4J是一个日志抽象库,在众多开源软件包中被广泛使用。由于它经常被误解为一个日志实现库,尤其是与其他日志实现库配合使用时,常常会报错,缺少中间层的jar包,因此有必要将它的配置方法记录一下。