Log4j重叠类警告原因解析及Maven项目依赖继承问题修复方案

1. 为什么Log4j会针对重叠类发出警告？ #

简单来说，这是因为你的类路径里同时存在功能冲突的日志桥接/实现类。举个典型场景：

• 比如你同时引入了log4j-over-slf4j（把Log4j API调用转接到SLF4J门面）和slf4j-log4j12（把SLF4J调用转接到Log4j实现），这两个包会包含同名的核心日志类（比如org.apache.log4j.Logger）。
• 或者你的项目里同时有原始的Log4j核心包和log4j-over-slf4j桥接包，JVM加载类的时候会因为找到重复的类定义而混乱，Log4j的检测机制发现这种情况就会抛出警告——毕竟这种冲突会导致日志行为不可预测，比如日志不输出、重复输出，甚至程序报错。

2. Maven项目中未显式定义log4j-over-slf4j但从Spring Boot继承而来，如何修复警告？ #

咱们可以按这几步来解决：

第一步：确认依赖来源 #

先运行Maven命令查看完整的依赖树，找出到底是哪个依赖间接引入了log4j-over-slf4j：

mvn dependency:tree -Dincludes=org.slf4j:log4j-over-slf4j

这个命令会精准定位到引入该依赖的父依赖，比如通常是spring-boot-starter-logging或者其他第三方starter。

第二步：排除冲突依赖 #

找到来源后，在你的POM.xml里给对应的父依赖添加排除配置。比如如果是spring-boot-starter-web间接引入的，就这么写：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>log4j-over-slf4j</artifactId>
        </exclusion>
    </exclusions>
</dependency>

如果是spring-boot-starter-logging本身引入的，就针对这个starter排除：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-logging</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>log4j-over-slf4j</artifactId>
        </exclusion>
    </exclusions>
</dependency>

第三步：验证配置 #

排除后再运行一次mvn dependency:tree命令，确认log4j-over-slf4j已经不在依赖树里了，然后启动项目，警告应该就消失了。

另外补充一点：如果你的项目是用Log4j2作为日志实现，确保你的依赖里只有log4j-slf4j-impl（SLF4J到Log4j2的桥接），不要同时存在其他冲突的桥接包，这样日志体系才会稳定。

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