Slf4j 包老冲突，到底怎么解决？

落日映苍穹つ 2022-09-15 12:44 156阅读 0赞

作者: Jitwxs  
链接: [https://jitwxs.cn/e2390047.html][https_jitwxs.cn_e2390047.html]

### 一、前言 ###

在进行 Java 开发时，通常我们会选择 Slf4j 作为日志门面，但日志实现却不尽相同。如果系统运行中同时存在多个日志实现，就会出现类似下图的 Warning。

![20211012131536951.png][]

### 二、问题原因 ###

我们知道 SpringBoot 默认使用的日志实现是 Logback，因此我们尝试在项目中引入 Log4j 的依赖时，就复现了上图的报错。

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
    </dependency>

上图报错告知我们存在多个 SLF4J bingdings，分别位于 logback 和 log4j 包中，有两个 StaticLoggerBinder。

我们知道使用 Slf4j ，需要 LoggerFactory.getLogger() 方法获取实例。

import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;

private final Logger logs = LoggerFactory.getLogger(xxx.class); 我们就可以通过这个作为入口，去看看源码的实现。如下图所示，我标注了需要关注的核心代码。

![20211012131537634.png][]

（1）调用 getILoggerFactory() 方法得到 LoggerFactory。

（2）对于首次调用，INITIALIZATION\_STATE 应该是 UNINITIALIZED，所以进入初始化的逻辑，调用方法 performInitialization()。

（3）调用 bind() 方法。

（4）如果不是 isAndroid()，调用

findPossibleStaticLoggerBinderPathSet() 方法，故名思意，查找可能的 staticLoggerBinder，注意这里返回的类型是 SET，即可能是多个。

（5）在findPossibleStaticLoggerBinderPathSet() 这个方法内，首先通过 classLoader 加载了 org/slf4j/impl/StaticLoggerBinder.class 这个类的 path，它可能存在多个，因此使用了 while 获取了所有的 path，并最终返回。

![20211012131538241.png][]

（6）reportActualBinding() 方法会校验 SET 的 size，如果大于 1，就会打印出一开始我们看见的 Warning 了。

![20211012131538899.png][]

### 三、问题解决 ###

解决思路就是将你不想要的日志实现从依赖包中排除掉即可，通过 IDEA 提供的 Diagrams 能够非常方便的查看项目中的依赖关系。

打开项目的 POM 文件，右键选择 Diagrams -> Show Dependencies

![20211012131539272.png][]

假设我们想要排除 logback 依赖，使用 log4j。Ctrl + F 搜索 logback，可以找到引用该依赖的树形结构。

![20211012131539716.png][]

点击窗口左上角的下图中的这个图标，可以只看当前选中的这个依赖的关系。

![20211012131539943.png][]

选中后效果如下：

![20211012131540199.png][]

如上图所示，logback 由 spring-boot-starter-logging 引入，最顶层是由 spring-boot-starter-web 和 spring-boot-starter-test 引入。

我们尝试在 spring-boot-starter-web 中排除该依赖，应该就可以了。如果排出后重新搜索仍然存在 logback 依赖，则重复执行排除的操作。

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <exclusions>
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

### 四、总结 ###

日志框架冲突特别对于新手来说处理起来比较头疼，因为涉及到了日志接口和日志实现。

我们推崇的应该是面向接口编程，因此我们大到开源项目，小到公司的公共 jar 包，应当合理利用 Maven 的传递机制。具体的日志实现不应该传递出去，避免影响到调用的下游方。

**近期热文推荐：**

1.[1,000+ 道 Java面试题及答案整理(2021最新版)][1_000_ _ Java_2021]

2.[别在再满屏的 if/ else 了，试试策略模式，真香！！][if_ else]

3.[卧槽！Java 中的 xx ≠ null 是什么新语法？][Java _ xx _ null]

4.[Spring Boot 2.5 重磅发布，黑暗模式太炸了！][Spring Boot 2.5]

5.[《Java开发手册（嵩山版）》最新发布，速速下载！][Java]

觉得不错，别忘了随手点赞+转发哦！

[https_jitwxs.cn_e2390047.html]: https://jitwxs.cn/e2390047.html
[20211012131536951.png]: /images/20220828/8c7846e2adc34425b26f88ccdde3964d.png
[20211012131537634.png]: /images/20220828/041431ad34364487999d0b1f05ddd21f.png
[20211012131538241.png]: /images/20220828/23c4ec94353c4734a109076b7b665466.png
[20211012131538899.png]: /images/20220828/3565d44df55345cf85bf4e1d49ab85a9.png
[20211012131539272.png]: /images/20220828/67889467d2aa401faab2d18df9257cad.png
[20211012131539716.png]: /images/20220828/4353ed08a798488691c1b369bfbf3b41.png
[20211012131539943.png]: /images/20220828/ca178d2a291d400a888c104988ab2901.png
[20211012131540199.png]: /images/20220828/e7be017cd08e489bb6012c6e8a13218e.png
[1_000_ _ Java_2021]: https://www.javastack.cn/mst/
[if_ else]: https://www.javastack.cn/article/2021/strategy-pattern-instead-of-if-else/
[Java _ xx _ null]: https://www.javastack.cn/article/2021/intellij-idea-ligatures-settings/
[Spring Boot 2.5]: https://www.javastack.cn/article/2021/spring-boot-2.5-released/
[Java]: http://www.javastack.cn/article/2020/alibaba-release-java-develop-rules-songshan/