Spring Boot 2.5.12升级后Logback初始化失败问题求助

核心问题拆解 #

升级后出现的两个关键报错指向两类问题：

• Logback加载配置时路径为null，说明Spring Boot无法正确定位classpath:logback-spring.xml
• org.xml.sax.SAXNotRecognizedException无法识别http://xml.org/sax/features/external-general-entities，这是XML解析器冲突或版本不兼容导致的

结合给出的依赖：org.slf4j:jcl-over-slf4j:1.7.30、ch.qos.logback:logback-classic:1.2.6，Spring Boot 2.5.12默认适配的Logback版本是1.2.9，手动指定1.2.6大概率会引发兼容性问题；同时项目中如果引入了第三方XML解析器（比如Xerces），也会和JDK自带解析器冲突，触发SAX特性识别失败。

分步解决办法 #

1. 对齐Spring Boot官方依赖版本 #

Spring Boot的依赖管理已经内置了适配各个版本的Logback版本，不要手动指定旧版本。直接移除pom.xml或build.gradle中手动声明的logback-classic:1.2.6，让框架自动引入对应版本（2.5.12对应1.2.9）。

Maven示例（移除以下依赖）：

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.6</version>
</dependency>

2. 排查并排除XML解析器冲突 #

用依赖分析工具找出项目中多余的XML解析器：

• Maven：执行mvn dependency:tree，查找xercesImpl或其他第三方解析器依赖
• Gradle：执行./gradlew dependencies，同样定位冲突依赖

找到后在对应依赖中排除冲突项，比如Maven中：

<dependency>
    <groupId>你的依赖groupId</groupId>
    <artifactId>你的依赖artifactId</artifactId>
    <exclusions>
        <exclusion>
            <groupId>xerces</groupId>
            <artifactId>xercesImpl</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 检查logback-spring.xml配置合法性 #

确保配置文件没有语法错误：

• 开头的XML声明和命名空间必须完整：

  <?xml version="1.0" encoding="UTF-8"?>
  <configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xsi:schemaLocation="http://logback.qos.ch/xml/ns/logback http://logback.qos.ch/xml/ns/logback/logback.xsd">
  

• 不要使用Logback已废弃的标签或属性
• 避免引用外部实体（这类配置可能触发SAX特性检查，引发报错）

4. 强制使用JDK默认XML解析器 #

在项目启动参数中添加以下配置，强制使用JDK自带的解析器，绕过第三方解析器的兼容性问题：

-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl

5. 确保日志自动配置未被禁用 #

检查启动类上的@SpringBootApplication注解，如果有exclude = {LoggingAutoConfiguration.class}，立即移除该配置。Spring Boot的日志自动配置是Logback初始化的核心，禁用后会导致配置加载异常。

验证流程 #

1. 清理并重新构建项目：Maven执行mvn clean install，Gradle执行./gradlew clean build
2. 启动项目，观察控制台是否不再出现初始化失败的报错
3. 如果仍有问题，添加启动参数-Dlogging.config=classpath:logback-spring.xml，明确指定配置文件路径，排查路径是否正确

内容的提问来源于stack exchange，提问作者Shamseer