Logback是Java后端主流日志框架，需引入SLF4J API和Logback Classic依赖，通过logback-spring.xml配置控制台与文件输出，支持按时间大小滚动、环境区分级别，并使用占位符记录结构化日志。
Java后端开发中，Logback 是 SLF4J 的原生实现，性能高、配置灵活，是目前主流的日志框架。要正确配置和使用 Logback，只需引入依赖、编写配置文件并调用日志接口即可。
添加 Maven 依赖
在 pom.xml 中加入 SLF4J API 和 Logback Classic 模块：
- <dependencyyoujiankuohaophpcn
- <groupId>org.slf4j</groupId>
- <artifactId>slf4j-api</artifactId>
- <version>1.7.36</version>
- </dependency>
- <dependency>
- <groupId>ch.qos.logback</groupId>
- <artifactId>logback-classic</artifactId>
- <version>1.2.11</version>
- </dependency>
只要这两个依赖存在，SLF4J 会自动绑定 Logback 作为底层实现。
创建 logback-spring.xml 配置文件
将配置文件放在 src/main/resources 目录下，推荐使用 logback-spring.xml（支持 Spring Boot 的 profile 功能）：
立即学习“Java免费学习笔记（深入）”；
<configuration>
<property name="LOG_PATH" value="./logs" />
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_PATH}/app.log</file>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>${LOGPATH}/archived/app%d{yyyy-MM-dd}.%i.gz</fileNamePattern>
<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
<maxFileSize>10MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
<maxHistory>30</maxHistory>
</rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{50} - %msg%n</pattern>
</encoder>
</appender>
<!-- 开发环境 -->
<springProfile name="dev">
<root level="DEBUG">
<appender-ref ref="CONSOLE" />
<appender-ref ref="FILE" />
</root>
</springProfile>
<!-- 生产环境 -->
<springProfile name="prod">
<root level="INFO">
<appender-ref ref="FILE" />
</root>
</springProfile>
</configuration>
说明：
- 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 或其他日志系统还能实现集中管理。不复杂但容易忽略细节，比如路径权限、归档策略等，上线前建议验证日志是否正常生成。
