日志框架

System.out.println 排障一次还行，上线后你需要 级别、格式、滚动文件与集中采集。Java 生态的标准答案是 SLF4J 门面 + Logback / Log4j2 实现——spring-boot-essentials 默认如此；本课让你在脱离 Spring 时也能正确配置，并与 java-core-essentials 的异常栈追踪配合。

学习目标

• 用 SLF4J API 写日志，理解门面与实现分离
• 配置 Logback 的控制台与按日滚动文件
• 区分 DEBUG/INFO/WARN/ERROR 的使用场景，避免日志噪音与敏感信息泄露

SLF4J 基本用法

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class PaymentService {
    private static final Logger log = LoggerFactory.getLogger(PaymentService.class);

    public void charge(String orderId, long amountCents) {
        log.info("charge start orderId={} amount={}", orderId, amountCents);
        try {
            // ... 调用支付网关
            log.debug("gateway response received orderId={}", orderId);
        } catch (Exception ex) {
            log.error("charge failed orderId={}", orderId, ex);
            throw ex;
        }
    }
}

占位符 {} 优于字符串拼接：实现层可延迟 toString()，且避免 null 拼接 NPE。

Logback 配置（logback.xml）

<configuration>
  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>logs/app.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>logs/app.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>14</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>%d ISO8601 [%thread] %-5level %logger - %msg%n</pattern>
    </encoder>
  </appender>

  <logger name="com.example.payment" level="DEBUG"/>
  <root level="INFO">
    <appender-ref ref="CONSOLE"/>
    <appender-ref ref="FILE"/>
  </root>
</configuration>

门面 vs 实现 vs 竞品

组件	角色
SLF4J	应用代码只依赖此 API
Logback	Spring Boot 默认实现，与 SLF4J 同作者
Log4j2	高性能替代，需 log4j-slf4j2-impl 桥接