Java程序运行时报错："log4j-slf4j-impl cannot be present with log4j-to-slf4j" 处理指南

WIBU

2025-04-28

Java程序运行时报错“log4j-slf4j-impl cannot be present with log4j-to-slf4j”通常由日志适配器冲突引起。通过移除log4j-slf4j-impl依赖、保持Spring Boot默认日志配置的一致性，可快速解决该问题。建议排查项目依赖树，规范日志框架使用。

在基于 Spring Boot 的 Java 项目中，若运行时遇到错误提示：

log4j-slf4j-impl cannot be present with log4j-to-slf4j

该错误主要由于日志系统适配包冲突导致。本文将对报错原因、技术背景及解决方案进行系统阐述，帮助开发者快速排除故障，保证程序正常运行。

SLF4J（Simple Logging Facade for Java）

是一种日志门面（Facade）框架，定义统一接口，允许绑定不同底层日志实现，如 Logback、Log4j、JUL等。

log4j-to-slf4j

是 Spring Boot 默认引入的桥接适配器，用于将老版本 Log4j 日志API调用重定向至 SLF4J 接口，再由 Logback 处理实际日志输出。

log4j-slf4j-impl

是 Log4j 2 提供的实现包，用于直接将 SLF4J API 调用交由 Log4j 2 处理。1.2 冲突原理

Spring Boot 默认采用 Logback 作为日志实现（通过 spring-boot-starter-logging引入），而不是使用Log4j。

因此同时存在以下两个依赖会导致冲突：

log4j-to-slf4j：负责桥接Log4j调用至SLF4J

log4j-slf4j-impl：负责实现SLF4J接口到Log4j 2

由于两者存在相互矛盾的职责（一个重定向，一个再实现），导致Spring Boot日志子系统初始化失败，从而抛出冲突异常。

项目引入依赖示例：

<!-- Spring Boot 默认日志依赖 -->
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-logging</artifactId>
</dependency>

<!-- 项目中错误地又手动引入了log4j-slf4j-impl -->
<dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-slf4j-impl</artifactId>
</dependency>

导致运行时报出：

java.lang.IllegalStateException: Logback configuration error detected: 
log4j-slf4j-impl cannot be present with log4j-to-slf4j

定位项目的 pom.xml 或其传递依赖链，找到并移除 log4j-slf4j-impl：

● 若手动添加了该依赖，请删除；

● 若为其他三方库间接引入，可通过 dependencyManagement 或 exclusion 排除该依赖。

示例 - 手动排除：

<dependency>
  <groupId>some.third.party</groupId>
  <artifactId>some-lib</artifactId>
  <exclusions>
    <exclusion>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-slf4j-impl</artifactId>
    </exclusion>
  </exclusions>
</dependency>

● 如果选择使用 Spring Boot默认的Logback，确保仅保留spring-boot-starter-logging；

● 如果确实需要迁移至 Log4j 2，则需要：

○ 排除默认的 spring-boot-starter-logging

○ 引入完整的 Log4j2 Starter 套件，如 spring-boot-starter-log4j2；

○ 同时确保移除 log4j-to-slf4j 桥接器，保持一致性。

● 排查依赖冲突：建议使用 Maven dependency:tree 命令检查冲突源头；

● 避免日志混合使用：Spring Boot推荐单一日志框架，避免SLF4J桥接混杂；

● 正确使用starter：使用官方Starter（如spring-boot-starter-log4j2）可以简化依赖管理，避免手动组合错误。

出现“log4j-slf4j-impl cannot be present with log4j-to-slf4j”错误，是由于同时存在两个日志适配器导致冲突。解决方案是移除不必要的 log4j-slf4j-impl，确保日志实现的一致性。

理解Spring Boot默认日志配置机制，合理配置依赖关系，可有效避免类似冲突问题。

1. CodeMeter Java 加密

2. Java 程序加密后在 linux 系统上需要安装哪些环境

3. AxProtector Java

本文导读

Java程序运行时报错："log4j-slf4j-impl cannot be present with log4j-to-slf4j" 处理指南

一、报错原因解析

1.1 背景技术知识

二、问题场景示例

三、正确的解决方案

3.1 移除冲突依赖

3.2 保持日志系统统一

四、注意事项与推荐实践

五、总结

推荐阅读：

热点推荐

重点关注