全栈攻城狮

Appearance

日志框架选型 ​

Java 日志体系演变 ​

Java 日志框架经历了从混乱到统一的演进过程：

text
1996 — System.out.println()    ← 原始时代
2000 — log4j 1.x               ← 首个流行日志框架
2002 — java.util.logging (JUL) ← JDK 内置，功能薄弱
2006 — logback                 ← log4j 作者打造，性能更强
2007 — SLF4J                   ← 门面（Facade）诞生
2012 — Log4j 2                 ← 重写，异步性能飞跃
2015 — Logback 成为 Spring Boot 默认
2021 — Log4j 2 爆出核弹级漏洞 CVE-2021-44228

Java 中有 4 种日志 API 和 4 种日志实现，关键是做好区分：

类型名称说明
门面（Facade）SLF4J日志门面，让实现可插拔。推荐使用
门面（Facade）Apache Commons Logging (JCL)较老的门面，Spring 内嵌使用
门面/实现java.util.logging (JUL)JDK 内置，无需额外依赖，功能有限
实现Logbacklog4j 作者新作，Spring Boot 默认
实现Log4j 2log4j 重写，异步性能最强
实现Log4j 1.x已停止维护，不应再使用

核心对比 ​

SLF4J — 行业标准的门面 ​

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

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

    public void createUser(User user) {
        log.info("创建用户: {}", user.getName());  // 占位符 {} 避免字符串拼接
        // 业务逻辑
    }
}

优势：

  • 占位符 {} 延迟字符串拼接，提升性能
  • 运行时绑定具体实现（classpath 机制）
  • 支持参数化日志、MDC（Mapped Diagnostic Context）

与 Log4j 1.x 对比：

java
// Log4j 1.x — 字符串拼接浪费性能
if (logger.isDebugEnabled()) {
    logger.debug("User: " + name + ", Age: " + age);
}

// SLF4J — 延迟拼接，仅当日志级别启用时执行
log.debug("User: {}, Age: {}", name, age);

Logback — Spring Boot 默认实现 ​

特点：

  • 与 SLF4J 同为 log4j 作者（Ceki Gülcü）打造
  • 原生支持 SLF4J，无需适配层
  • 自动重载配置（scan 机制）
  • 支持条件化配置（Janino）

Log4j 2 — 异步性能最强 ​

特点：

  • 异步日志基于 LMAX Disruptor（无锁队列），远超 Logback
  • 插件化架构，扩展性好
  • 支持无垃圾（Garbage-free）模式
  • 支持 Lambda 表达式延迟计算

性能对比（TPS） ​

场景LogbackLog4j 2 同步Log4j 2 异步
纯日志输出120 万150 万800 万
带 MDC80 万100 万600 万

数据来源：Apache Log4j 2 官方基准测试。Log4j 2 异步日志的性能优势来自 Disruptor 无锁队列。

架构图 ​

SLF4J 绑定机制 ​

text
                    应用程序代码
                        │
                   ┌────┴────┐
                   │  SLF4J  │  ← 门面，编译期依赖
                   └────┬────┘
                        │ classpath 自动绑定
          ┌─────────────┼─────────────┐
          │             │             │
    ┌─────┴─────┐ ┌────┴────┐ ┌─────┴─────┐
    │log4j绑定包 │ │logback  │ │log4j2绑定包│
    │slf4j-log4j│ │原生支持 │ │log4j-slf4j│
    └─────┬─────┘ └─────────┘ └─────┬─────┘
          │                         │
    ┌─────┴─────┐            ┌──────┴──────┐
    │ Log4j 1.x │            │  Log4j 2    │
    └───────────┘            └─────────────┘

绑定依赖 ​

xml
<!-- Logback（Spring Boot 默认）-->
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
</dependency>

<!-- Log4j 2 + SLF4J -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

<!-- 排除默认的 Logback -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

选型建议 ​

场景推荐原因
Spring Boot 项目Logback开箱即用，无需额外配置
高并发、低延迟Log4j 2 异步Disruptor 无锁队列，延迟最低
已有 Log4j 1.x 遗留项目迁移至 Log4j 21.x 已退役，安全漏洞多
需要无垃圾模式Log4j 2支持 GC-free，减少停顿
简单小项目Logback配置简单，文档完善
需要与 Spring 整合Logback 或 Log4j 2都有良好的 Spring Boot 支持

通用建议 ​

text
1. 无论选哪种实现，编程 API 都用 SLF4J
2. 新项目优先 Logback（简单）
3. 高并发项目选用 Log4j 2 异步模式
4. 永远不要直接依赖 Log4j 1.x
5. 日志配置外置，支持运行时动态调整