如何解决Logback 1.5与1.2依赖下的SLF4J兼容性问题

核心问题分析 #

你的场景冲突根源在于：Logback 1.2依赖SLF4J 1.x，而Logback 1.5适配SLF4J 2.x，同时hapi-fhir 6.8.8强制使用SLF4J 2.x。当项目同时存在两个版本的Logback时，会触发类加载冲突（如LoggerContext、Appender等类版本不兼容），且SLF4J 2.x的ServiceLoader机制无法适配旧版Logback。以下是无需切换到Log4j的可行解决方案：

可行解决方案 #

1. 强制统一使用Logback 1.5，排除所有旧版依赖 #

Logback 1.5向下兼容大部分1.2的公开API，优先尝试这种方案，直接在构建工具中强制指定版本并排除旧版依赖：

Maven配置示例

<dependencyManagement>
    <dependencies>
        <!-- 强制统一Logback版本为1.5.x -->
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.5.6</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-core</artifactId>
            <version>1.5.6</version>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- 对引入Logback 1.2的第三方依赖，逐一排除旧版 -->
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>old-dependency</artifactId>
        <version>1.0.0</version>
        <exclusions>
            <exclusion>
                <groupId>ch.qos.logback</groupId>
                <artifactId>logback-classic</artifactId>
            </exclusion>
            <exclusion>
                <groupId>ch.qos.logback</groupId>
                <artifactId>logback-core</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

Gradle配置示例

configurations.all {
    resolutionStrategy {
        force 'ch.qos.logback:logback-classic:1.5.6', 'ch.qos.logback:logback-core:1.5.6'
        // 全局排除旧版Logback
        exclude group: 'ch.qos.logback', module: 'logback-classic'
        exclude group: 'ch.qos.logback', module: 'logback-core'
    }
}

dependencies {
    // 显式引入Logback 1.5
    implementation 'ch.qos.logback:logback-classic:1.5.6'
}

2. 引入Logback兼容模块处理API差异 #

如果强制升级后旧库出现API兼容问题（比如调用了Logback 1.2的内部私有API），可以引入Logback官方提供的兼容模块，将旧API调用转发到1.5的实现：

Maven配置

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-compat</artifactId>
    <version>1.5.6</version>
</dependency>

Gradle配置

implementation 'ch.qos.logback:logback-compat:1.5.6'

3. 固定SLF4J 2.x的服务提供者 #

SLF4J 2.x使用ServiceLoader加载日志实现，若旧版Logback JAR未完全排除，可能出现多个SLF4JServiceProvider冲突。此时在项目src/main/resources/META-INF/services/目录下创建org.slf4j.spi.SLF4JServiceProvider文件，内容为：

ch.qos.logback.classic.spi.LogbackServiceProvider

确保SLF4J仅加载Logback 1.5的服务实现。

Spring Boot 2.7.x适配注意事项 #

Spring Boot 2.7.x默认依赖SLF4J 1.x，需通过属性覆盖升级到兼容Logback 1.5的版本：

<!-- Maven -->
<properties>
    <slf4j.version>2.0.9</slf4j.version>
</properties>

Spring Boot的spring-boot-starter-logging会自动引入Logback，只需强制指定版本即可，无需额外排除。

验证步骤 #

1. 检查依赖树，确认所有Logback依赖均为1.5.x版本：

   # Maven
   mvn dependency:tree | grep logback
   # Gradle
   ./gradlew dependencies | grep logback
   

2. 启动应用，确认无SLF4J: Class path contains multiple SLF4J bindings或类版本冲突报错，日志输出正常。

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