Logback是Java后端主流日志框架，需引入SLF4J API和Logback Classic依赖，通过logback-spring.xml配置控制台与文件输出，支持按时间大小滚动、环境区分级别，并使用占位符记录结构化日志。
Java后端开发中，Logback 是 SLF4J 的原生实现，性能高、配置灵活，是目前主流的日志框架。要正确配置和使用 Logback，只需引入依赖、编写配置文件并调用日志接口即可。
添加 Maven 依赖
在 pom.xml 中加入 SLF4J API 和 Logback Classic 模块：
-
org.slf4j -
slf4j-api -
1.7.36 -
ch.qos.logback -
logback-classic -
1.2.11
只要这两个依赖存在，SLF4J 会自动绑定 Logback 作为底层实现。
创建 logback-spring.xml 配置文件
将配置文件放在 src/main/resources 目录下，推荐使用 logback-spring.xml（支持 Spring Boot 的 profile 功能）：
立即学习“Java免费学习笔记（深入）”；
appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
说明：
- ConsoleAppender 输出到控制台
- RollingFileAppender 按时间和大小滚动日志文件
- 使用 springProfile 区分不同环境日志级别
- 日志格式包含时间、线程、级别、类名和消息
在代码中使用日志
通过 SLF4J 的 Logger 接口记录日志，Spring Boot 项目中直接注入或声明即可：
@Component
public class UserService {
private static final Logger log = LoggerFactory.getLogger(UserService.class);
public void createUser(String name) {
log.debug("开始创建用户: {}", name);
if (name == null || name.isEmpty()) {
log.error("用户名不能为空");
throw new IllegalArgumentException("Name is required");
}
log.info("用户创建成功: {}", name);
}
}
常用日志级别：
- TRACE：最详细信息，调试用
- DEBUG：开发调试信息
- INFO：关键流程提示
- WARN：潜在问题警告
- ERROR：错误事件，但应用仍可运行
注意事项与最佳实践
避免字符串拼接，使用占位符提升性能：
// 推荐 ✔️log.debug("用户ID: {}, 操作: {}", userId, action);
// 不推荐 ❌
log.debug("用户ID: " + userId + ", 操作: " + action);
确保日志内容清晰、结构化，便于排查问题。生产环境关闭 DEBUG 输出，防止影响性能和磁盘占用。
基本上就这些，配置一次后可长期复用，结合 ELK 或其他日志系统还能实现集中管理。不复杂但容易忽略细节，比如路径权限、归档策略等，上线前建议验证日志是否正常生成。
