Log4j 2.x 實戰指南：配置詳解、多輸出目的地、異步日誌與最佳實踐

Log4j 核心三大組件

1. Logger（記錄器）：日志輸出入口，層級控制（OFF > FATAL > ERROR > WARN > INFO > DEBUG > TRACE > ALL）。
2. Appender（輸出端）：決定日志去向——控制台、文件、滾動文件、數據庫、Socket、Syslog、Kafka 等。
3. Layout（佈局）：定義日志格式——PatternLayout（最常用）、JSONLayout、HTMLLayout、SyslogLayout 等。

配置文件格式對比

Log4j 2.x 推薦使用 XML、YAML、JSON 或 Properties。XML 功能最全、IDE 支持最好；Properties 簡潔但不支持部分高級特性（如異步、腳本過濾）。

XML 配置範例（生產級模板）

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" monitorInterval="30">
  <Properties>
    <Property name="LOG_DIR">logs</Property>
    <Property name="PATTERN">%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n</Property>
  </Properties>

  <Appenders>
    <!-- 控制台 -->
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="${PATTERN}"/>
    </Console>

    <!-- 按天滾動，保留 30 天 -->
    <RollingFile name="RollingFile" fileName="${LOG_DIR}/app.log"
                 filePattern="${LOG_DIR}/$${date:yyyy-MM}/app-%d{yyyy-MM-dd}-%i.log.gz">
      <PatternLayout pattern="${PATTERN}"/>
      <Policies>
        <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
        <SizeBasedTriggeringPolicy size="100 MB"/>
      </Policies>
      <DefaultRolloverStrategy max="20"/>
    </RollingFile>

    <!-- 錯誤級別單獨文件 -->
    <RollingFile name="ErrorFile" fileName="${LOG_DIR}/error.log"
                 filePattern="${LOG_DIR}/error-%d{yyyy-MM-dd}.log.gz">
      <ThresholdFilter level="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>
      <PatternLayout pattern="${PATTERN}"/>
      <Policies><TimeBasedTriggeringPolicy/></Policies>
    </RollingFile>

    <!-- 異步包裝器：高吞吐低延遲 -->
    <Async name="AsyncRoot">
      <AppenderRef ref="RollingFile"/>
      <AppenderRef ref="ErrorFile"/>
      <AppenderRef ref="Console"/>
    </Async>
  </Appenders>

  <Loggers>
    <!-- 第三方庫級別控制 -->
    <Logger name="org.springframework" level="INFO"/>
    <Logger name="org.hibernate" level="WARN"/>
    <Logger name="com.zaxxer.hikari" level="INFO"/>

    <!-- 業務代碼 -->
    <Logger name="com.mycompany" level="DEBUG" additivity="false">
      <AppenderRef ref="AsyncRoot"/>
    </Logger>

    <Root level="INFO">
      <AppenderRef ref="AsyncRoot"/>
    </Root>
  </Loggers>
</Configuration>

關鍵配置解析

代碼中正確使用 Log4j 2

1. 獲取 Logger（推薦靜態常量）

public class OrderService {
    private static final Logger logger = LogManager.getLogger(OrderService.class);
    // 或使用 Lombok @Slf4j 註解自動生成
}

2. 條件輸出避免字符串拼接開銷

// 差：無論級別皆執行拼接
logger.debug("Processing order " + orderId + " for user " + user.getName());

// 好：僅 DEBUG 級別啟用時執行 Lambda
logger.debug("Processing order {} for user {}", () -> orderId, () -> user.getName());

// 更好：參數化佔位符（Log4j 2 自動延遲計算）
logger.debug("Processing order {} for user {}", orderId, user::getName);

3. 結構化日志（JSON）便於 ELK 分析

在 Layout 中使用 JSONLayout 或 LogstashLayout，配合 MDC 埋點：

MDC.put("traceId", traceId);
MDC.put("userId", userId);
try {
    logger.info("Order created");
} finally {
    MDC.clear();
}

進階場景實戰

多環境差異化配置

使用 Spring Profile 激活不同配置文件：log4j2-spring.xml 中引用 ...。

數據庫批量寫入

使用 JDBCAppender 配合 BufferSize 批量提交，避免每條日志一次事務：

<JDBC name="Database" tableName="sys_log" bufferSize="100">
  <DataSource jndiName="java:comp/env/jdbc/LogDS" />
  <Column name="created" pattern="%d{yyyy-MM-dd HH:mm:ss}"/>
  <Column name="level" pattern="%level"/>
  <Column name="logger" pattern="%logger{36}"/>
  <Column name="message" pattern="%msg"/>
  <Column name="trace_id" pattern="%X{traceId}"/>
</JDBC>

Kafka/ELK 實時流式傳輸

生產環境推薦：KafkaAppender → Logstash → Elasticsearch → Kibana，實現日志集中化、全文檢索、告警儀表盤。

避坑指南與性能優化

1. 移除 log4j 1.x 依賴：使用 log4j-1.2-api 橋接舊代碼，統一遷移至 2.x。
2. 關閉即時刷新：immediateFlush="false" 配合 Async 緩衝，極大提升吞吐。
3. 避免在熱點路徑打印大對象：序列化開銷大，改用異步或采樣日志。
4. 容器化部署：日志輸出 stdout/stderr，由 Sidecar (Filebeat/Fluentd) 採集，不掛載宿主機目錄。
5. Log4j2 漏洞 (CVE-2021-44228)：務必升級至 2.17.1+，設置 log4j2.formatMsgNoLookups=true 或移除 JndiLookup 類。

總結

Log4j 2.x 憑藉異步無鎖架構、豐富 Appender 生態、熱加載、JSON/結構化輸出，成為 Java 生態事實標準。掌握「分級輸出、異步解耦、結構化字段、集中化采集」四大原則，構建可觀測、高性能、易運維的日志體系。