引入log4j2依赖后通过slf4j桥接至log4j1仍报配置文件未找到
解决log4j2 StatusLogger配置文件找不到的报错
这个报错我太熟了——本质上是你的类路径里还留着log4j2的核心组件,导致它的StatusLogger启动时硬要找自己的配置文件,哪怕你已经做了桥接转发的配置。咱们一步步来解决:
1. 先砍掉log4j2的核心依赖
你只需要log4j-api(2.X版本)来接收log4j2风格的日志,再通过log4j-to-slf4j转发到SLF4J,完全不需要log4j-core这个jar包。它就是触发这个报错的元凶。
Maven配置示例
在你的pom.xml里,给log4j-to-slf4j依赖加上排除规则:
<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-to-slf4j</artifactId> <version>你的2.X版本号</version> <exclusions> <exclusion> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-core</artifactId> </exclusion> </exclusions> </dependency>
同时检查其他引入的依赖,有没有偷偷带进来log4j-core,如果有同样要排除。
Gradle配置示例
在build.gradle里做类似的排除:
implementation('org.apache.logging.log4j:log4j-to-slf4j:你的2.X版本号') { exclude group: 'org.apache.logging.log4j', module: 'log4j-core' }
2. 确认桥接依赖的版本兼容性
log4j-to-slf4j的版本必须和log4j-api的版本完全一致(都是2.X),不然会出现API不兼容的问题。slf4j-log4j12的版本要和你的SLF4J API版本匹配,同时要确保它和你使用的log4j 1.X版本兼容(比如slf4j-log4j12 1.7.x对应log4j 1.2.x)。
3. 验证依赖树(关键步骤)
用构建工具的依赖树命令,确认log4j-core已经完全从类路径中消失:
- Maven:
mvn dependency:tree | grep log4j-core,如果没有输出就说明排除成功了。 - Gradle:
./gradlew dependencies | grep log4j-core,同样看是否有结果。
4. 应急方案(治标不治本)
如果暂时没法排除log4j-core,可以通过系统属性直接关掉StatusLogger的输出:
在启动应用时加上参数:
-Dlog4j2.status=OFF
但还是建议优先排除log4j-core,从根源解决问题。
为什么会出现这个问题?
log4j2的StatusLogger是log4j-core包里的组件,只要这个jar存在于类路径,JVM启动时它就会自动初始化,尝试加载log4j2的配置文件(比如log4j2.xml/log4j2.properties)。而我们的目标是让所有log4j2的日志都通过桥接转到log4j 1.X,所以log4j-core完全是多余的,留着只会添乱。
内容的提问来源于stack exchange,提问作者Sebastien Diot
相关产品推荐
相关产品推荐

