推荐使用SLF4J + Logback组合,因其性能好、配置灵活且为Spring Boot默认方案;若需兼容Log4j 2.x,则通过SLF4J桥接并排除默认日志依赖,同时避免多绑定冲突。

在Java项目中搭建日志环境,推荐优先使用 SLF4J + Logback 组合(Logback是SLF4J的原生实现,性能好、配置灵活),而不是过时的Log4j 1.x。若必须兼容Log4j 2.x,也可通过SLF4J桥接使用。
SLF4J + Logback(推荐方案)
这是当前Spring Boot及主流项目的默认日志方案,无需额外桥接,开箱即用。
- 只需引入
spring-boot-starter-logging(Spring Boot项目默认已含)或手动添加以下Maven依赖:
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>2.0.13</version>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.4.14</version>
</dependency>
Logback会自动加载 src/main/resources/logback.xml 或 logback-spring.xml(后者支持Spring Profile)。
SLF4J + Log4j 2.x(需桥接)
适用于已有Log4j 2.x配置、需复用或强制要求使用Log4j 2的场景。注意:SLF4J本身不实现日志输出,需绑定具体实现。
立即学习“Java免费学习笔记(深入)”;
- 排除默认Logback,引入Log4j 2绑定器和核心包:
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
<version>2.21.1</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.21.1</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.21.1</version>
</dependency>
配置文件命名为 log4j2.xml 或 log4j2.yml,放在 resources 目录下即可生效。
避免常见冲突问题
混合引入多个日志实现会导致SLF4J报错(如“Class path contains multiple SLF4J bindings”)。
- 用
mvn dependency:tree | grep slf4j检查重复绑定 - 确保项目中只存在 一个 SLF4J binding(如
logback-classic或log4j-slf4j-impl,不能共存) - 旧项目若用了
slf4j-log4j12,请升级替换(Log4j 1.x已停止维护且有严重安全漏洞)
代码中如何使用(统一写法)
无论底层是Logback还是Log4j 2,业务代码保持一致:
private static final Logger log = LoggerFactory.getLogger(YourClass.class);public void doSomething() {
log.info("处理开始,参数:{}", param);
log.error("发生异常", e);
}
SLF4J的占位符({})可避免字符串拼接开销,也支持多参数,比直接用 + 更安全高效。
基本上就这些。选对组合、配好依赖、避开冲突,日志就能稳稳跑起来。










