日志框架选型：Log4j、Logback、Log4j2 对比与选型策略

说实话，每次新项目启动，总有人问我：「日志框架用哪个？随便选一个不就行了？」

我一般会反问一句：「你线上出问题的时候，日志能帮你几分钟定位到根因吗？」

日志框架选型，看着是小事，但选错了，后面全是坑。我见过太多团队因为日志框架性能问题，导致系统在高并发下直接卡死。嗯，今天咱们就把这三个主流框架掰开揉碎，讲清楚。

一、三兄弟的出身与现状

先简单捋一下历史。Log4j 是 Apache 的老牌框架，2001 年就出来了。Logback 是 Log4j 的作者 Ceki Gülcü 后来写的，算是亲儿子。Log4j 2 则是 Apache 另起炉灶，吸收了 Logback 的优点，又做了大量优化。

我个人的习惯是：新项目直接上 Log4j 2。为什么？往下看。

二、性能对比：谁更快？

性能是选型的核心指标。你想想看，一个高并发系统，每秒几万次请求，日志框架如果成为瓶颈，那整个系统都得跟着遭殃。

我直接说结论：Log4j 2 的异步日志性能是 Logback 的 5-10 倍。

为什么差距这么大？关键在于底层实现：

• Log4j 1.x：每个 appender 都加锁，写日志时线程阻塞。
• Logback：虽然用了 AsyncAppender，但底层还是基于 BlockingQueue，有锁竞争。
• Log4j 2：基于 LMAX Disruptor 的无锁环形缓冲区，说白了就是 CAS 操作替代了锁，吞吐量直接起飞。

我记得有一次帮客户做性能调优，他们用的是 Logback，压测到 2000 TPS 时日志就开始丢。换成 Log4j 2 异步模式后，同样的机器跑到 8000 TPS，日志一条没丢。

三、配置方式与灵活性

配置这块，Log4j 2 做得最舒服。支持 XML、JSON、YAML、Properties 四种格式。我个人习惯用 YAML，可读性好。

看一个 Log4j 2 的 YAML 配置示例：

Configuration:
  status: warn
  name: MyAppConfig
  appenders:
    Console:
      name: STDOUT
      target: SYSTEM_OUT
      PatternLayout:
        pattern: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"
    RollingFile:
      name: RollingFile
      fileName: logs/app.log
      filePattern: logs/app-%d{yyyy-MM-dd}-%i.log.gz
      PatternLayout:
        pattern: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"
      Policies:
        TimeBasedTriggeringPolicy:
          interval: 1
          modulate: true
        SizeBasedTriggeringPolicy:
          size: "100 MB"
      DefaultRolloverStrategy:
        max: 30
  loggers:
    root:
      level: info
      appenderRef:
        - ref: STDOUT
        - ref: RollingFile

四、异步日志的正确打开方式

很多人以为用了异步日志就万事大吉了。其实不然。我见过不少案例，异步日志反而把系统搞崩了。

Log4j 2 的异步日志有两种模式：

1. AsyncAppender：传统的异步方式，底层用 BlockingQueue。
2. AsyncLogger：基于 Disruptor 的无锁异步，这才是真正的性能利器。

我建议直接用 AsyncLogger。配置方式很简单：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="warn">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
    </Console>
  </Appenders>
  <Loggers>
    <AsyncLogger name="com.example" level="info" includeLocation="false">
      <AppenderRef ref="Console"/>
    </AsyncLogger>
    <Root level="info">
      <AppenderRef ref="Console"/>
    </Root>
  </Loggers>
</Configuration>

五、选型决策树

说了这么多，到底怎么选？我画了一张图，帮你快速决策：

六、避坑指南

最后，分享几个我踩过的坑：

• 不要混用日志框架：项目中可能依赖了多个第三方库，它们可能用了不同的日志框架。记得用 SLF4J 做桥接，统一输出。
• 异步日志的队列大小：默认的队列大小是 1024，如果写入速度远大于消费速度，队列满了会丢日志。我一般设到 8192 或 16384。
• 磁盘 I/O 是最终瓶颈：不管日志框架多快，最终都要写磁盘。建议把日志目录放到单独的磁盘上，或者用 SSD。
• 日志级别别乱用：线上环境不要开 DEBUG，否则日志量能把你磁盘撑爆。我曾经见过一个团队，线上误开了 DEBUG，半天时间 200GB 磁盘就满了。