快捷導(dǎo)航

SpringBoot2.7.x將logback升級(jí)到1.3.x以上版本的全過(guò)程解析

更新時(shí)間：2026年04月20日 09:48:17 作者：netyeaxi

這篇文章給大家介紹SpringBoot：SpringBoot2.7.x如何將logback升級(jí)到1.3.x以上版本,本文給大家分享報(bào)錯(cuò)原因及解決方案,感興趣的朋友跟隨小編一起看看吧

SpringBoot2.7.x默認(rèn)使用的是logback-1.2.x及以下版本，而如果使用logback-1.3.x及以上版本，啟動(dòng)就會(huì)報(bào)錯(cuò)。主要原因是SpringBoot2.7.x會(huì)依賴logback-classic-1.2.x中的類org.slf4j.impl.StaticLoggerBinder，而logback-classic-1.3.x中已經(jīng)將此類刪除了。

一、報(bào)錯(cuò)原因分析

下面通過(guò)分析源代碼查找報(bào)錯(cuò)原因，組件版本如下：

spring-boot-2.7.18

logback-classic-1.2.11

SpringBoot啟動(dòng)時(shí)會(huì)調(diào)用方法LoggingApplicationListener.onApplicationEnvironmentPreparedEvent，其中會(huì)獲取到LoggingSystem的實(shí)例：

而生成LoggingSystem實(shí)例的方法是LoggingSystem.get

其中SYSTEM_PROPERTY=org.springframework.boot.logging.LoggingSystem

若SYSTEM_PROPERTY的值是LoggingSystem的實(shí)現(xiàn)類的類名，比如：org.springframework.boot.logging.logback.LogbackLoggingSystem，則會(huì)創(chuàng)建這個(gè)類的實(shí)例；

若SYSTEM_PROPERTY的值是NONE，則生成NoOpLoggingSystem；

否則，springboot會(huì)在類路徑中自己去查找有哪些日志組件，然后實(shí)例化。

在onApplicationEnvironmentPreparedEvent中獲取到LoggingSystem實(shí)例后，就會(huì)調(diào)用initialize方法：

在其中會(huì)調(diào)用initializeSystem方法

其中CONFIG_PROPERTY=logging.config，也就是從環(huán)境變量logging.config中獲取logback的配置文件，然后使用LogbackLoggingSystem.initialize對(duì)logback進(jìn)行初始化

查看getLoggerContext()的源代碼

可以看到StaticLoggerBinder是在這個(gè)地方被用到了。

二、解決方案

通過(guò)分析上面的源代碼就可以知道，如果想讓SpringBoot2.7.x使用logback-classic-1.3.x及以上版本，則需要先將環(huán)境變量org.springframework.boot.logging.LoggingSystem的值設(shè)置成none，也就是不讓SpringBoot幫忙初始化logback，改由應(yīng)用自己初始化logback。

另外，logback-classic升級(jí)到1.3.x以上版本，slf4j也要升級(jí)到1.8.x及以上版本，原因可以參考《Java：logback-classic與slf4j版本對(duì)應(yīng)關(guān)系》。

最后，如果logback配置文件的路徑以前是通過(guò)環(huán)境變量logging.config配置的，則需要將logback配置文件的路徑通過(guò)環(huán)境變量logback.configurationFile進(jìn)行配置：

其中CONFIG_FILE_PROPERTY=logback.configurationFile

上述源代碼屬于logback-classic組件，版本如下：

logback-classic-1.3.15

另外，以上給出的解決方案logback的官方網(wǎng)站上也有，大家可以參考一下：

地址：https://logback.qos.ch/download.html

三、進(jìn)一步說(shuō)明

如果應(yīng)用是在servlet3.0以上容器部署時(shí)，logback會(huì)由ch.qos.logback.servlet.LogbackServletContainerInitializer初始化，而springboot由org.springframework.web.SpringServletContainerInitializer初始化，這2個(gè)類都實(shí)現(xiàn)了javax.servlet.ServletContainerInitializer接口。一般servlet容器會(huì)先執(zhí)行LogbackServletContainerInitializer，這樣就會(huì)把logback初始化完成，所以logback一般不是在執(zhí)行SpringServletContainerInitializer的過(guò)程中初始化的。

這就解釋了為什么只能通過(guò)環(huán)境變量logback.configurationFile配置logback.xml的路徑，因?yàn)橄胪ㄟ^(guò)spring的配置設(shè)置logback.xml的路徑已經(jīng)錯(cuò)過(guò)機(jī)會(huì)了。

到此這篇關(guān)于SpringBoot2.7.x將logback升級(jí)到1.3.x以上版本的全過(guò)程解析的文章就介紹到這了,更多相關(guān)SpringBoot將logback升級(jí)到1.3.x版本內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: