SLF4J是日志门面，编译期依赖slf4j-api，运行时绑定唯一具体实现（如logback-classic）；代码仅用Logger/LoggerFactory，配置由底层框架（如logback.xml）处理，替换实现只需改依赖与配置。
SLF4J（Simple Logging Facade for Java）是一个日志门面，它不提供日志实现，而是通过统一的 API 让代码与具体日志框架（如 Logback、Log4j2、java.util.logging）解耦。使用它的核心在于：**编译期依赖 SLF4J API，运行时绑定一个具体的日志实现（binding）**。
1. 引入 SLF4J API 和一个具体 binding
项目中只需引入两样东西：
- slf4j-api.jar（必须）：定义 Logger、LoggerFactory 等接口，你的业务代码只依赖它；
-
一个 binding jar（有且仅有一个）：比如
logback-classic.jar（自带 slf4j-api 兼容）、slf4j-log4j12.jar或slf4j-jdk14.jar，负责将 SLF4J 调用转给对应日志框架。
以 Maven 为例（使用 Logback）：
<dependency> <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-classic 已包含对 slf4j-api 的实现，无需额外加 binding 模块；若选 Log4j2，则需 slf4j-api + log4j-slf4j2-impl（注意版本匹配）。
立即学习“Java免费学习笔记（深入）”；
2. 代码中只面向 SLF4J API 编程
所有日志操作都通过 org.slf4j.Logger 和 org.slf4j.LoggerFactory，不 import 任何 Logback/Log4j 的类：
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class UserService {
private static final Logger log = LoggerFactory.getLogger(UserService.class);
public void createUser(String name) {
log.info("Creating user: {}", name); // 占位符方式，避免字符串拼接
if (name == null) {
log.warn("User name is null, using default");
}
}
}
这样写完后，你的业务模块完全不知道底层是 Logback 还是 Log4j2 —— 替换日志实现只需改依赖和配置文件，不改一行 Java 代码。
3. 避免常见绑定冲突
SLF4J 启动时会检查 classpath 中是否存在多个 binding，如果发现就会报类似警告：
SLF4J: Class path contains multiple SLF4J bindings.这通常是因为引入了多个日志实现（例如同时存在 logback-classic 和 slf4j-log4j12），或某些第三方库偷偷传递依赖了别的 binding。解决方法：
- 用
mvn dependency:tree -Dincludes=org.slf4j查看哪些依赖引入了 SLF4J binding； - 对冲突的依赖做
<exclusion>排除其自带的 logging binding； - 确保最终 classpath 下只有一个 binding JAR（如只有
logback-classic）。
4. 日志配置交给具体实现处理
SLF4J 不管配置格式，由绑定框架负责解析。例如：
- 用 Logback → 放
logback.xml或logback-spring.xml在src/main/resources； - 用 Log4j2 → 放
log4j2.xml； - 用 JUL（java.util.logging）→ 用
logging.properties，但一般不推荐。
配置内容（如输出格式、级别、文件路径）完全由具体框架决定，SLF4J 层无感知 —— 这正是门面模式的价值所在。
