1. 什么是 LogbackLogback 是 Java 社区最流行的日志框架之一由 Log4j 创始人 Ceki Gülcü 设计是 Log4j 的升级替代品。它天然集成 SLF4JSimple Logging Facade for Java性能更高、配置更灵活、功能更丰富。简单来说Logback 帮你回答三个问题谁在记录—— Logger日志记录器输出到哪里—— Appender输出目的地什么格式输出—— Layout / Encoder输出格式2. 快速上手Maven 依赖在pom.xml中添加以下依赖dependency groupIdch.qos.logback/groupId artifactIdlogback-classic/artifactId version1.4.14/version /dependency添加后Logback 会自动引入logback-core和slf4j-api无需额外配置即可使用。3. 第一个示例零配置跑起来Logback 遵循约定优于配置原则。即使没有logback.xml它也会使用默认配置输出到控制台日志级别为 DEBUG。import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class HelloLogback { // 获取 Logger 实例参数为当前类 private static final Logger log LoggerFactory.getLogger(HelloLogback.class); public static void main(String[] args) { log.trace(这是 TRACE 级别); log.debug(这是 DEBUG 级别); log.info(这是 INFO 级别); log.warn(这是 WARN 级别); log.error(这是 ERROR 级别); } }运行后控制台会输出类似14:32:10.123 [main] DEBUG HelloLogback - 这是 DEBUG 级别 14:32:10.125 [main] INFO HelloLogback - 这是 INFO 级别 14:32:10.125 [main] WARN HelloLogback - 这是 WARN 级别 14:32:10.125 [main] ERROR HelloLogback - 这是 ERROR 级别注意TRACE级别默认不输出因为默认级别是 DEBUG。4. 核心概念详解4.1 Logger日志记录器Logger 是开发者直接使用的 API。它按名称分层通常以类的全限定名命名Logger log LoggerFactory.getLogger(com.example.MyService);Logger 有继承关系com.example.MyService的父 Logger 是com.example根 Logger 是ROOT。子 Logger 如果没有设置级别会继承父 Logger 的级别。4.2 日志级别Logback 定义了 5 个级别优先级从低到高级别用途生产环境建议TRACE最细粒度的调试信息关闭DEBUG开发调试信息关闭INFO关键运行状态开启WARN潜在问题警告开启ERROR错误和异常开启只有级别大于等于 Logger 有效级别的日志才会输出。例如 Logger 级别为 INFO则 TRACE 和 DEBUG 被过滤。4.3 Appender输出目的地Appender 决定日志写到哪里。常见 Appender 有ConsoleAppender输出到控制台FileAppender输出到文件RollingFileAppender按时间或大小滚动文件4.4 Layout / Encoder输出格式Layout 控制日志的文本格式。Logback 推荐使用PatternLayoutEncoder通过%d、%level、%logger、%msg等占位符自定义格式。5. 配置文件详解logback.xml将logback.xml放在src/main/resources下Logback 会自动加载。下面是一个完整的实战配置?xml version1.0 encodingUTF-8? configuration !-- 定义变量方便统一管理 -- property nameLOG_HOME value/var/log/myapp / property nameLOG_PATTERN value%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n / !-- 控制台输出 -- appender nameCONSOLE classch.qos.logback.core.ConsoleAppender encoder pattern${LOG_PATTERN}/pattern /encoder /appender !-- 按天滚动的文件输出 -- appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender file${LOG_HOME}/app.log/file rollingPolicy classch.qos.logback.core.rolling.TimeBasedRollingPolicy fileNamePattern${LOG_HOME}/app.%d{yyyy-MM-dd}.log/fileNamePattern maxHistory30/maxHistory /rollingPolicy encoder pattern${LOG_PATTERN}/pattern /encoder /appender !-- 根 Logger 配置 -- root levelINFO appender-ref refCONSOLE / appender-ref refFILE / /root !-- 对特定包设置不同级别 -- logger namecom.example.dao levelDEBUG / logger nameorg.springframework levelWARN / /configuration配置说明property定义变量避免硬编码appender定义输出目的地可以定义多个root根 Logger所有 Logger 的最终父级logger对特定包或类单独设置级别rollingPolicy滚动策略这里按天滚动保留 30 天6. 实战在 Spring Boot 中使用 LogbackSpring Boot 默认使用 Logback只需在application.yml中简单配置即可logging: level: root: INFO com.example.myapp: DEBUG file: name: logs/myapp.log pattern: console: %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n如果需要更复杂的配置如按天滚动仍然使用logback-spring.xmlSpring Boot 推荐命名支持springProfile标签区分环境!-- 开发环境输出 DEBUG -- springProfile namedev root levelDEBUG appender-ref refCONSOLE / /root /springProfile !-- 生产环境只输出 INFO 以上到文件 -- springProfile nameprod root levelINFO appender-ref refFILE / /root /springProfile7. 常见问题与最佳实践7.1 日志性能优化Logback 内部使用异步 Appender 避免日志 I/O 阻塞业务线程appender nameASYNC_FILE classch.qos.logback.classic.AsyncAppender appender-ref refFILE / queueSize512/queueSize discardingThreshold0/discardingThreshold /appender7.2 避免字符串拼接推荐使用占位符{}避免不必要的字符串拼接// 不推荐 log.debug(User id: userId , name: name); // 推荐 log.debug(User id: {}, name: {}, userId, name);当日志级别不满足时占位符方式不会执行字符串拼接性能更好。7.3 不要记录敏感信息避免在日志中输出密码、身份证号、银行卡号等敏感信息。如果必须记录请先脱敏。8. 总结Logback 是 Java 生态中成熟、高效的日志框架核心要点如下三要素Logger谁记录、Appender输出到哪、Layout/Encoder什么格式配置文件logback.xml放在 classpath 根目录支持变量和滚动策略级别控制TRACE DEBUG INFO WARN ERROR生产环境建议 INFO 以上性能建议使用异步 Appender 占位符{}避免字符串拼接Spring Boot 集成开箱即用推荐logback-spring.xml配合springProfile
)
