导航：首页 > 开发技术 >

Java日志出问题的原因有哪些

发表于：2024-11-21 作者：千家信息网编辑

千家信息网最后更新 2024年11月21日，本篇内容主要讲解"Java日志出问题的原因有哪些"，感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷，实用性强。下面就让小编来带大家学习"Java日志出问题的原因有哪些"吧!用了那么久的日志框架，你

千家信息网最后更新 2024年11月21日Java日志出问题的原因有哪些

本篇内容主要讲解"Java日志出问题的原因有哪些"，感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷，实用性强。下面就让小编来带大家学习"Java日志出问题的原因有哪些"吧!

用了那么久的日志框架，你是否仍会遇到即使配置了日志，日志依然不知去向？

来接受下面的 8 连发灵魂拷问！

Q1：你是否遇到过配置了logback，启动时却提示log4j错误的情况？像下面这样：

log4j:WARN No appenders could be found for logger (org.example.App).  log4j:WARN Please initialize the log4j system properly.  log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.

Q2：你是否遇到过 SLF4J 的这种报错？

SLF4J: Class path contains multiple SLF4J bindings.  SLF4J: Found binding in [jar:file:/C:/Users/jiang/.m2/repository/ch/qos/logback/logback-classic/1.2.3/logback-classic-1.2.3.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: Found binding in [jar:file:/C:/Users/jiang/.m2/repository/org/slf4j/slf4j-log4j12/1.7.30/slf4j-log4j12-1.7.30.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation. SLF4J: Actual binding is of type [ch.qos.logback.classic.util.ContextSelectorStaticBinder]

Q3：你是否遇到过DUBBO日志打印不正常的情况？

Q4：你是否遇到过Mybatis SQL日志打印不出来的情况？

Q5：你是否遇到过JPA/Hibernate SQL日志无法打印的情况？

Q6：你是否遇到过复杂项目中，很多框架内部日志无法打印的情况？

Q7：你是否遇到过Tomcat工程，日志文件打印了多份，catalina.out和其他文件？

Q8：你是否遇到过SpringBoot项目，日志文件打印了多份的问题？

What！你还遇到过其他各种日志配置问题……

## 日志框架的冲突这些问题，基本都是由于多套日志框架共存或配置错误导致的。> 为什么会出现共存或者冲突呢？

一般是以下几种原因：

项目手动引用了各种日志框架的包，比如同时引用了log4j/log4j2/logback/jboss-logging/jcl等
包管理工具的传递依赖（Transitive Dependencies）导致，比如依赖了dubbo，但是dubbo依赖了zkclient，可zkclient又依赖了log4j，此时如果你的项目中还有其他日志框架存在并有使用，那么就会导致多套共存
同一个日志框架多版本共存

JAVA里的各种日志框架

在正式介绍冲突和解决之前，需要先简单的说一下Java中的各种日志框架：

Java 中的日志框架分为两种，分别为日志抽象/门面，日志实现

日志抽象/门面

不负责具体的日志打印，如输出到文件、配置日志内容格式等。这只是一套日志抽象，定义了一套统一的日志打印标准，如Logger对象，Level对象。

slf4j（Simple Logging Facade for Java）和 jcl（Apache Commons Logging）这两个日志框架就是JAVA中最主流的日志抽象了。

还有一个 jboss-logging，主要用于jboss系列软件，比如hibernate之类。像 jcl 已经多年不更新了（上一次更新时间还是14年），目前最推荐的是使用 slf4j。

日志实现

Java 中的日志实现框架，主流的有以下几种：

log4j，Apache（老牌日志框架，不过多年不更新了，新版本为log4j2）
log4j2，Apache（log4j 的新版本，目前异步IO性能最强，配置也较简单）
logback，QOS（slf4j就是这家公司的产品）
jul（java.util.logging），这是jdk内置

在程序中，可以直接使用日志框架，也可以使用日志抽象+日志实现搭配的方案。不过一般都是用日志抽象+日志实现，这样更灵活，适配起来更简单。

目前最主流的方案是 slf4j+logback/log4j2，不过如果是jboss系列的产品，可能用的更多的还是 jboss-logging，毕竟自家产的，总得用上去，是吧！像 JPA/Hibernate 这种框架里，内置的就是 jboss-logging。

SpringBoot + Dubbo 日志框架冲突的例子

举个例子来说个最常见的传递依赖导致的共存冲突：比如我有一个"干净的"spring-boot项目，干净到只有一个spring-boot-starter依赖，此时我想集成dubbo，使用zookeeper作为注册中心，此时我的依赖配置是这样：

          org.springframework.boot      spring-boot-starter              org.apache.dubbo      dubbo-spring-boot-starter      2.7.9              org.apache.dubbo      dubbo-registry-zookeeper      2.7.9

现在启动这个spring-boot项目，会发现一堆红色错误：

SLF4J: Class path contains multiple SLF4J bindings.  SLF4J: Found binding in [jar:file:/C:/Users/jiang/.m2/repository/ch/qos/logback/logback-classic/1.2.3/logback-classic-1.2.3.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: Found binding in [jar:file:/C:/Users/jiang/.m2/repository/org/slf4j/slf4j-log4j12/1.7.30/slf4j-log4j12-1.7.30.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation. SLF4J: Actual binding is of type [ch.qos.logback.classic.util.ContextSelectorStaticBinder] ----------------------------------我是分割线----------------------------------------  log4j:WARN No appenders could be found for logger (org.apache.dubbo.common.logger.LoggerFactory).  log4j:WARN Please initialize the log4j system properly.  log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.

从错误提示上看，错误内容分为两个部分：

slf4j报错，提示找到多个slf4j的日志绑定
log4j报错，提示log4j没有appender配置

出现这个错误，就是因为 dubbo 的传递依赖中含有 log4j，但是 spring-boot 的默认配置是 slf4j+logback。在依赖了 dubbo 相关包之后，现在项目中同时存在 logback/jcl(apache commons-logging)/log4j/jul-to-slf4j/slf4j-log4j/log4j-to-slf4j。

来看一下依赖图：

这个时候就乱套了，slf4j-log4j 是 log4j 的 slf4j 实现，作用是调用 slf4j api 的时候使用 log4j 输出；而 log4j-to-slf4j 的作用是将 log4j 的实现替换为 log4j，这样一来造成了死循环。

而且还有 logback 的存在，logback 默认实现了 slf4j 的抽象，而 slf4j-log4j 也是一样实现了 slf4j 的抽象。

logback 项目里共存了两套 slf4j的实现，那么在使用slf4j接口打印的时候会使用哪个实现呢？

答案是"第一个"，也就是第一个被加载的Slf4j的实现类，但这种依靠ClassLoader加载顺序来保证的日志配置顺序是非常不靠谱的。

如果想正常使用日志，让这个项目里所有的框架都正常打印日志，必须将日志框架统一。不过这里的统一并不是至强行修改，而是用"适配/中转"的方式。

现在项目里虽然有 slf4j-log4j 的配置，但这个配置是适配 log4j2 用的，而我们的依赖了只有 log4j1，实际上这个中转是无效的。但logback是有效的，而且是 spring-boot 项目的默认配置，这次就选择 logback 作为项目的统一日志框架吧！

现在项目里存在 log4j(1) 的包，而且启动时又报 log4j 的错误，说明某些代码调用了 log4j 的 api。但我们又不想用 log4j，所以需要先解决 log4j 的问题。

由于有 log4j 代码的引用，所以直接删除 log4j 一定是不可行的。slf4j 提供了一个 log4j-over-slf4j 的包，这个包复制了一份 log4j1 的接口类（Logger等），同时将实现类修改为 slf4j 了。

所以将 log4j 的（传递）依赖排除，同时引用 log4j-over-slf4j，就解决了这个 log4j 的问题。现在来修改下 pom 中的依赖（查看依赖图可以使用 maven 的命令，或者是 IDEA 自带的 Maven Dependencies Diagram，再或者 Maven Helper 之类的插件）。

    org.apache.dubbo    dubbo-registry-zookeeper    2.7.9    compile                      log4j        log4j                      org.slf4j      log4j-over-slf4j      1.7.30

解决了log4j的问题之后，现在还有 slf4j 有两个实现的问题，这个问题处理就更简单了。由于我们计划使用 logback，那么只需要排除/删除 slf4j-log4j 这个实现的依赖即可。

    org.apache.dubbo    dubbo-registry-zookeeper    2.7.9    compile                  log4j        log4j                    slf4j-log4j12        org.slf4j