推荐使用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依赖:
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绑定器和核心包:
配置文件命名为 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的占位符({})可避免字符串拼接开销,也支持多参数,比直接用 + 更安全高效。
基本上就这些。选对组合、配好依赖、避开冲突,日志就能稳稳跑起来。










