Logback 日志入门

1. 一句话简介

Logback 是 Java 生态中最主流的日志框架之一，由 log4j 的作者 Ceki Gülcü 开发，是 SLF4J 门面（接口）的默认实现之一。它负责把程序运行过程中的关键信息（启动状态、业务数据、异常堆栈等）按级别记录到控制台、文件或其他目标。

Logback 核心解决的是「日志该记什么、记在哪、记多久、怎么存」的问题：通过 Logger（日志级别控制）、Appender（输出目标）、Layout/Encoder（输出格式）、Filter（过滤规则）这些概念，灵活编排日志从产生到落盘再到自动清理的全过程。Spring Boot 以其作为默认日志后端，开箱即用。

在本模块 demo-logback 中，通过一个 logback-spring.xml 就实现了控制台实时输出、INFO 与 ERROR 按级别分文件存储、日志按天并按大小（2MB）滚动切分、自动保留最近 90 天并清理旧文件的完整能力，正是上述能力的直观体现。

2. 什么时候使用

✅ 适用场景
- Spring Boot 项目：spring-boot-starter-web 中已内置 Logback，无需单独引入依赖，写日志即可用，是默认最佳实践。
- 需要分级输出日志：想让 INFO/WARN 和 ERROR 分开存储，便于定位问题与做监控告警（本模块用 LevelFilter 与 ThresholdFilter 实现）。
- 日志需要落盘持久化并对文件做管理：文件按天滚动、按大小切分，防止单文件过大撑满磁盘，并自动保留最近 N 天（本模块 TimeBasedRollingPolicy + maxHistory=90）。
- 需要灵活定义输出格式：可自定义时间、线程、类名、行号、异常堆栈等字段（本模块 FILE_ERROR_PATTERN 就额外包含了 %file:%line 便于定位错误）。
- 需要面向排查快速接入：用 Lombok 的 @Slf4j 注解即可获得 Logger 实例，代码侵入极小（本模块启动类即以此打印五个级别的日志）。
❌ 不适用 / 需谨慎
- 对写入吞吐率要求极高、日志量极大的高并发系统：Logback 默认同步阻塞写日志会成为瓶颈，急需异步日志时 Log4j2 的 AsyncLogger 更有优势。
- 追求配置简洁度：Logback 主要通过 XML 配置（logback-spring.xml），语法偏繁琐，若想要 YAML/JSON 声明式配置，Log4j2 更友好。
- 需要对接特定日志规范或已有强制要求：部分大型企业或基础设施强制要求 JUL 或 Log4j2，需跟随组织规范而非常规选型。
- 对启动/运行期内存占用极度敏感的场景：多 Appender + 复杂过滤器会引入一定对象分配开销，极端瘦身场景需要权衡。

3. 常见业务场景

应用启动与运行状态监控：在启动类打印容器中初始化的 Bean 数量、关键配置、各组件初始化结果（SpringBootDemoLogbackApplication 用 getBeanDefinitionNames().length 记录启动时注册了多少 Bean）。适合的 Logback 原因：可把启动关键信息同时打到控制台和文件，作为每次部署的"启动现场"留档。
异常与错误追踪：用 try-catch 包裹可能出错的业务代码，在 catch 中通过 log.error("消息", e) 打印完整异常堆栈。适合的原因：Logback 自动把堆栈写入独立的 ERROR 日志文件（本例 error.*.log），配上文件名和行号，运维不必翻海量正常日志即可定位问题。
按级别分区归档、分级告警：INFO 日志记录正常业务流转（请求入参、耗时、链路状态），ERROR 日志单独归档用于对接告警系统。适合的原因：LevelFilter（onMatch=DENY 排除 ERROR）与 ThresholdFilter（只接受 ERROR 及以上）让两类日志互不干扰，方便下游系统按文件差异化消费。
日志文件滚动与磁盘空间治理：高流量系统单日日志量可上 GB，若不控制会迅速占满磁盘。适合的原因：TimeBasedRollingPolicy 按天切分、SizeAndTimeBasedFNATP 在单文件超过阈值时继续切分、maxHistory=90 自动清理 90 天前的旧文件，实现无人值守。
问题回溯与审计取证：把用户关键操作、交易流水、状态变更等以 INFO/WARN 级别落盘，配合按日归档文件长期回看。适合的原因：Logback 文件按 created_on_日期.part_序号 命名、保留期可控，能按时间段精准定位与取档。

4. 同类技术对比

技术	与 Spring Boot 集成	配置方式	性能 / 异步日志	功能（滚动、过滤）	适用规模
Logback	默认内置，零额外依赖	XML（`logback-spring.xml`）	常规同步够用，异步需手动配置	强，滚动/过滤/编码齐备	中小型及常规生产
Log4j2	需排除默认 Logback 依赖，额外引入	JSON/YAML/XML 皆可	异步日志（AsyncLogger）性能最强	强，且支持无 GC 等高级特性	高吞吐、高并发大型系统
JUL (java.util.logging)	需额外 bridge 集成	properties 配置	功能弱	弱，不支持滚动策略	简单脚本 / 轻量小项目

注：三者在编程接口上均可通过 SLF4J 门面统一调用（本模块即以 @Slf4j + org.slf4j.Logger 使用 Logback），切换底层实现无需改业务代码。

选型建议

默认场景（Spring Boot 常规项目、日志量中等）优先选 Logback：零依赖接入、文档丰富、功能齐全，满足绝大多数生产需求。
当出现单日文件刷写成为瓶颈、日志吞吐成为性能短板时，升级到 Log4j2：其异步 Logger 在高并发下吞吐最优，但也需在 pom 中排除 Logback 并承担必要的配置成本。
仅用于极简脚本、不关心持久化与滚动时，可考虑 JUL：JDK 内置零成本，但功能有限，不宜用在正式业务系统。核心原则是：业务代码面向 SLF4J 编码，底层实现按需求在 Logback 与 Log4j2 间切换。