SpringBoot2.7.x将logback升级到1.3.x以上版本的全过程解析
SpringBoot2.7.x将logback升级到1.3.x以上版本的全过程解析 不少开发者在尝试将SpringBoot 2.7.x项目中的Logback升级到1.3.x或更高版本时，都会遇到一个典型的启动报错。这背后的原因其实很明确：SpringBoot 2.7.x默认依赖的是logback-c
SpringBoot2.7.x将logback升级到1.3.x以上版本的全过程解析
不少开发者在尝试将SpringBoot 2.7.x项目中的Logback升级到1.3.x或更高版本时，都会遇到一个典型的启动报错。这背后的原因其实很明确：SpringBoot 2.7.x默认依赖的是logback-classic-1.2.x及以下版本，而到了1.3.x版本，Logback团队移除了一个关键类org.slf4j.impl.StaticLoggerBinder，这个类恰恰是SpringBoot启动时所依赖的。版本不匹配，冲突自然就来了。
一、报错原因分析
要彻底搞清楚这个问题，最好的办法就是顺着源代码走一遍。我们以以下版本组合为例：
spring-boot-2.7.18
logback-classic-1.2.11
SpringBoot应用启动时，会触发LoggingApplicationListener.onApplicationEnvironmentPreparedEvent方法。这个方法的核心任务之一，就是获取一个LoggingSystem的实例。这个过程如下图所示：
那么，LoggingSystem实例是如何生成的呢？关键在LoggingSystem.get这个方法里：
这里有个系统属性SYSTEM_PROPERTY，其值为org.springframework.boot.logging.LoggingSystem。它的作用是指定日志系统：
- 如果这个属性的值是一个
LoggingSystem实现类的全限定名（比如org.springframework.boot.logging.logback.LogbackLoggingSystem），SpringBoot就会直接实例化它。 - 如果值被设为
NONE，则会生成一个什么都不做的NoOpLoggingSystem。 - 如果既没指定也不是NONE，SpringBoot就会自动扫描类路径，寻找可用的日志框架并初始化。
拿到LoggingSystem实例后，紧接着就会调用其initialize方法：
这个方法内部会进一步调用initializeSystem：
注意这里的CONFIG_PROPERTY，它对应环境变量logging.config，也就是用来指定Logback配置文件路径的。之后，SpringBoot会使用LogbackLoggingSystem.initialize来初始化Logback：
问题就出在getLoggerContext()这个方法里。我们来看它的源代码：
看明白了吗？正是在这里，代码直接引用了StaticLoggerBinder.getSingleton().getLoggerFactory()。而在Logback 1.3.x中，这个StaticLoggerBinder类已经被移除了。所以，当SpringBoot 2.7.x试图用老办法初始化新版本的Logback时，类找不到，报错也就成了必然。
二、解决方案
分析完源码，解决方案就清晰了。核心思路就一句话：绕过SpringBoot的自动初始化，让应用自己来管理Logback的启动。
具体操作分三步：
第一步，关闭SpringBoot的日志系统自动配置。 将系统属性 org.springframework.boot.logging.LoggingSystem 的值设置为 none。这样，SpringBoot在启动时就不会尝试去初始化和绑定Logback了。
第二步，同步升级SLF4J。 将Logback升级到1.3.x时，别忘了它的搭档SLF4J也需要同步升级到1.8.x或更高版本。具体的版本对应关系，可以参考相关文档（如《Ja va：logback-classic与slf4j版本对应关系》）。
第三步，更换配置文件路径的指定方式。 如果你之前是通过环境变量 logging.config 来指定Logback配置文件（如logback.xml）的位置，现在需要改为使用Logback原生支持的 logback.configurationFile 环境变量。原因在下面的源码中一目了然：
（注：上述源码截图来自logback-classic-1.3.15）
其实，这个解决方案在Logback的官网上也有明确说明。下图来自其下载页面：
地址：https://logback.qos.ch/download.html
官网的建议也验证了我们的分析：在Spring Boot等框架中，需要通过设置org.springframework.boot.logging.LoggingSystem=none来禁用其日志系统，并直接使用Logback自身的初始化机制。
三、进一步说明
可能有人会问，为什么一定要换成logback.configurationFile，而不能继续用Spring Boot的logging.config呢？这涉及到Web应用中的初始化顺序问题。
对于部署在Servlet 3.0及以上容器（比如Tomcat）的应用，Logback的初始化通常是由ch.qos.logback.servlet.LogbackServletContainerInitializer这个类来完成的。而Spring Boot自身的初始化则是由org.springframework.web.SpringServletContainerInitializer负责。这两个类都实现了ja vax.servlet.ServletContainerInitializer接口。
关键在于，Servlet容器往往会先执行LogbackServletContainerInitializer。这意味着，在Spring Boot还没来得及插手之前，Logback就已经按照自己的规则初始化完毕了。所以，等到Spring Boot想通过logging.config去配置Logback时，时机已经错过了，配置自然不会生效。
因此，在混合升级的场景下，使用Logback原生支持的logback.configurationFile环境变量来指定配置路径，是确保配置能够被正确加载的唯一可靠方式。
Postman是一套面向API全生命周期的开发与测试平台，可在Mac上发送和调试多种协议请求，管理集合、环境及认证信息，并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用，提供个人免费方案。
Docker Desktop 是 Docker 官方为 Mac 提供的容器开发环境，集成 Docker Engine、命令行工具、Compose、Build、Kubernetes 与图形化管理界面。
Android Studio 是 Google 面向安卓应用开发提供的官方集成开发环境，基于 IntelliJ IDEA 构建。它整合智能代码编辑、Gradle 构建、界面预览、设备模拟、性能分析、调试测试及 APK 分析等工具。
Xcode 是苹果面向 Mac 提供的官方集成开发环境，将代码编辑、项目构建、SwiftUI 实时预览、设备模拟、自动化测试、断点调试、性能分析和应用分发整合在同一套工作流中，适合开发与维护 iPhone、iPad、Mac、Apple Wa
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
Visual Studio Code 是微软提供的免费代码编辑器，支持 macOS，并为 Intel 与 Apple 芯片 Mac 提供适配版本。软件集代码编辑、调试、Git 源代码管理、集成终端和扩展市场于一体。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Pro Tools 是 Avid 推出的专业数字音频工作站，覆盖多轨录音、无损剪辑、MIDI 编曲、插件处理、自动化混音及声音与画面同步等工作。它拥有 Intro、Artist、Studio 和 Ultimate 等方案。
PixPix 是面向品牌、卖家和内容团队的在线 AI 图片视频创作平台，提供图视频 Agent、无限画布、图片生成、视频生成、自然语言编辑及商品套图、产品精修和带货视频等电商工具。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求，并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等
Docker Desktop 为 Windows 开发者提供集成式容器环境，内置 Docker Engine、命令行工具、Compose、Build 与 Kubernetes 等组件，可在本机完成镜像构建、容器运行、日志查看和资源管理。
Android Studio 是 Google 面向 Android 应用开发提供的官方集成开发环境，以 IntelliJ IDEA 为基础，集成智能代码编辑、Gradle 构建、设备模拟、界面预览、调试测试及性能分析工具，
WebStorm 是 JetBrains 面向 JavaScript、TypeScript 和现代 Web 技术打造的集成开发环境。它提供项目级代码分析、智能补全、安全重构、导航搜索，并集成调试、测试、终端、Git 与常用前端工具，
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境，提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序，
PyCharm 是 JetBrains 推出的 Python 集成开发环境，提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能，
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境，提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目，
Visual Studio Code 是微软推出的免费代码编辑器，Windows 版集成智能补全、代码导航、调试、终端和版本控制，并可通过扩展添加语言、格式化及远程开发能力。它启动较快、配置灵活，
REAPER 是 Cockos 推出的数字音频工作站，适用于录音、MIDI 编曲、音频编辑、混音、母带制作及声音设计。软件安装包小巧，支持多轨录制、灵活路由、自动化、第三方插件和脚本扩展，并提供完整功能的 60 天免费评估期。
Adobe Audition 是面向播客、影视后期、广播与音乐制作的专业音频工作站，提供波形编辑、多轨混音、频谱分析、录音、降噪修复和效果处理等功能。Windows 版通过 Adobe Creative Cloud 安装和管理，
Pro Tools 是 Avid 推出的专业数字音频工作站，提供多轨录音、音频剪辑、MIDI编曲、插件处理、自动化混音及影视声音制作能力。它适合音乐人、录音师、制作人和音频后期团队使用，并提供免费入门版、订阅方案及永久授权选择。