Java日志配置：Log4j与SLF4J详解

今日不肯埋头，明日何以抬头！每日一句努力自己的话哈哈~哈喽，今天我将给大家带来一篇《Java日志配置指南：Log4j与SLF4J详解》，主要内容是讲解等等，感兴趣的朋友可以收藏或者有更好的建议在评论提出，我都会认真看的！大家一起进步，一起学习！

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 且无格式），你以为配好了，其实根本没加载。

有效配置路径与优先级（从高到低）：

• 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 时，用 干掉它的日志实现，例如：

<dependency>
  <groupId>com.example</groupId>
  <artifactId>some-lib</artifactId>
  <exclusions>
    <exclusion>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
    </exclusion>
  </exclusions>
</dependency>

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 的异步能力。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~