解决Spring Boot中Commons Logging冲突警告

问题描述

在使用Spring Boot 3.1.1开发应用时，控制台出现以下警告信息：

Standard Commons Logging discovery in action with spring-jcl: please remove commons-logging.jar from classpath in order to avoid potential conflicts

此警告表示项目中同时存在commons-logging库和spring-jcl日志框架，可能导致日志系统冲突。根据Maven依赖树分析，问题由以下传递依赖引起：

项目直接依赖unirest-java(1.4.9)
unirest-java依赖httpclient(4.5.2)
httpclient依赖commons-logging(1.2)

Spring Boot 3.x自带了spring-jcl作为默认日志框架实现，当同时存在commons-logging时，可能会导致日志行为不一致或冲突。

解决方案

方案1：排除特定的传递依赖（推荐）

在unirest-java依赖项中直接排除commons-logging组件：

xml

<dependencies>
    <dependency>
        <groupId>com.mashape.unirest</groupId>
        <artifactId>unirest-java</artifactId>
        <version>1.4.9</version>
        <exclusions>
            <exclusion>
                <groupId>commons-logging</groupId>
                <artifactId>commons-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

方案2：全局排除依赖（适用于多模块项目）

在项目级配置中全局排除commons-logging：

xml

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
            <version>1.2</version>
            <scope>provided</scope> <!-- 设置为provided避免引入 -->
        </dependency>
    </dependencies>
</dependencyManagement>

方案3：Gradle解决方案

对于使用Gradle的项目，可通过以下方式排除：

groovy

implementation('com.mashape.unirest:unirest-java:1.4.9') {
    exclude group: 'commons-logging', module: 'commons-logging'
}

或全局排除：

groovy

configurations.runtimeOnly {
    exclude(group: "commons-logging", module: "commons-logging")
}

技术解析

依赖关系分析
- Spring Boot的spring-jcl是Apache Commons Logging的重新实现
- 当两者共存时，可能导致日志框架初始化混乱
- 排除commons-logging后完全由spring-jcl处理日志
解决方案选择原则
验证排除结果 执行以下Maven命令检查：
bash
```
mvn dependency:tree -Dincludes=commons-logging
```
成功排除后应无输出结果

注意事项

排除后需进行完整测试，确保所有日志功能正常工作
使用全局排除时需评估对其他依赖的影响
不推荐手动删除JAR文件，这会导致构建不可重复

总结

移除commons-logging库可解决Spring Boot 3.x的日志冲突警告。推荐方案是在unirest-java依赖中直接添加exclusion排除。排除后Spring Boot的spring-jcl将无缝接管日志功能，无需额外配置，同时保持应用日志行为的一致性。

xml

<!-- 完整修复方案示例 -->
<dependency>
    <groupId>com.mashape.unirest</groupId>
    <artifactId>unirest-java</artifactId>
    <version>1.4.9</version>
    <exclusions>
        <exclusion>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

实际应用中，建议使用mvn dependency:analyze定期检查依赖关系，避免类似冲突问题重现。

相关文章

解决Spring Boot中Commons Logging冲突警告 ​

问题描述 ​

解决方案 ​

方案1：排除特定的传递依赖（推荐） ​

方案2：全局排除依赖（适用于多模块项目） ​

方案3：Gradle解决方案 ​

技术解析 ​

总结 ​