Log4j与SLF4J是分层协作关系:SLF4J为日志门面API,Log4j2为实现;需通过log4j-slf4j2-impl绑定,排除旧版冲突包,并正确配置log4j2.yaml等文件于resources下。

Log4j 和 SLF4J 不是“二选一”的关系,而是分层协作:SLF4J 是日志门面(API),Log4j2(注意不是 Log4j 1.x)才是真正的日志实现。直接用 Log4j 1.x 已不安全,Log4j 2.17.0+ 才修复了严重 RCE 漏洞;而 SLF4J 本身不输出日志,必须绑定一个具体实现(如 log4j-slf4j2-impl)。
为什么不能直接依赖 log4j-api + log4j-core 而跳过 SLF4J?
多数主流框架(Spring Boot、Apache Commons、Hibernate)默认使用 SLF4J 接口打日志。如果你项目里只引入 log4j-api 和 log4j-core,但框架内部调用的是 org.slf4j.Logger,就会触发 NoClassDefFoundError: org/slf4j/Logger 或静默失效——因为没桥接。
正确做法是:
- 声明
slf4j-api为 compile 依赖(所有代码写org.slf4j.LoggerFactory.getLogger(...)) - 选一个 binding 实现,比如
log4j-slf4j2-impl(对应 Log4j2) - 同时引入
log4j-core(log4j-slf4j2-impl不含它,会报NoClassDefFoundError: org/apache/logging/log4j/core/Appender) - 务必排除掉旧的
slf4j-log4j12、log4j-1.2.17等冲突包(Maven 中用)
Log4j2 的配置文件名和位置怎么才生效?
Log4j2 默认按固定顺序查找配置文件,名称或后缀不对就退回到控制台简单输出(ConsoleAppender 且无格式),你以为配好了,其实根本没加载。
立即学习“Java免费学习笔记(深入)”;
有效配置路径与优先级(从高到低):
-
log4j2-test.yaml/log4j2-test.yml(测试环境优先) -
log4j2-test.json/log4j2-test.jsn log4j2-test.xml-
log4j2.yaml/log4j2.yml(推荐,YAML 更易读) -
log4j2.json/log4j2.jsn log4j2.xml
必须放在 src/main/resources/ 下(或 classpath 根目录)。如果用 Maven 多模块,确认该资源被最终打包进 jar 的 BOOT-INF/classes/(Spring Boot)或根目录。
SLF4J 绑定冲突导致 “Multiple bindings” 警告怎么办?
运行时看到类似警告:
SLF4J: Class path contains multiple SLF4J bindings. SLF4J: Found binding in [jar:file:/.../log4j-slf4j2-impl-2.20.0.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: Found binding in [jar:file:/.../slf4j-simple-1.7.36.jar!/org/slf4j/impl/StaticLoggerBinder.class]
说明 classpath 里混入了多个 SLF4J binding(如 slf4j-simple、slf4j-log4j12、logback-classic)。SLF4J 会随机选一个,行为不可控。
排查方式:
- Maven:执行
mvn dependency:tree -Dincludes=org.slf4j:,看哪些依赖偷偷拉了别的 binding - Spring Boot 项目:检查是否误加了
spring-boot-starter-log4j2和spring-boot-starter-logging共存(后者含 Logback) - 显式排除:在引入第三方 starter 时,用
干掉它的日志实现,例如:
com.example some-lib org.slf4j slf4j-log4j12
Log4j2 异步日志为什么没生效?
想提升性能启用异步,但发现 AsyncLogger 没起作用,日志还是同步刷盘。常见原因:
- 没加 JVM 参数:
-Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector(Log4j2.17+ 可省略,但低版本必须) - 配置中用了
但没启用includeLocation="false"(否则每次都要取堆栈,失去异步意义) - 依赖缺失:
disruptor-3.4.4.jar(Log4j2 异步核心,Maven 需显式声明,尤其 Spring Boot 2.6+ 默认不带) - Logger 获取方式错误:必须用
org.apache.logging.log4j.LogManager.getLogger(...),而不是 SLF4J 的LoggerFactory(SLF4J binding 层不透传 AsyncLogger)
真正对 SLF4J 生效的异步方案,是统一用 Log4j2 做底层实现,并确保 binding 正确 —— 这样你写 LoggerFactory.getLogger(...),背后仍是 Log4j2 的异步能力。










