Log4j 2.x 實戰配置指南：非同步日誌、滾動策略、多環境隔離與效能調優

Log4j 2 是 Java 生態新一代日誌框架，基於 LMAX Disruptor 非同步架構，效能較 Log4j 1.x 提升 10 倍以上。本文提供生產級配置模板，涵蓋非同步日誌、滾動文件、多環境隔離、參數化日誌、效能調優全方位實戰。

Maven 依賴 (Log4j 2.23+)

    org.apache.logging.log4j
    log4j-api
    2.23.1


    org.apache.logging.log4j
    log4j-core
    2.23.1



    com.lmax
    disruptor
    3.4.4



    org.apache.logging.log4j
    log4j-slf4j2-impl
    2.23.1

log4j2.xml 生產級配置模板

    
    
        %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n
        logs
        myapp
    

    
    
        
        
            
        

        
        
            
            
                
                
            
            
        

        
        
            
            
                
            
            
                
                
            
        

        
        
            
            
        
        
            
        
    

    
    
        
        
            
             
        

        
        
            
        

        
        
            
        
        
            
        
    

核心配置解析

Java 代碼最佳實踐

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

public class OrderService {
    // 靜態最終，類加載時初始化，避免重複創建
    private static final Logger log = LoggerFactory.getLogger(OrderService.class);

    public void createOrder(OrderDTO dto) {
        // 參數化日誌：滿足級別才構建字符串，避免無效字符串拼接
        log.info("創建訂單: userId={}, amount={}, items={}", 
                 dto.getUserId(), dto.getAmount(), dto.getItems());
        
        try {
            // 業務邏輯
        } catch (Exception e) {
            // 異常必帶參數上下文，堆棧信息自動記錄
            log.error("訂單創建失敗: orderNo={}, userId={}", 
                      dto.getOrderNo(), dto.getUserId(), e);
            throw new BusinessException("創建失敗", e);
        }
    }
}

多環境隔離配置

或用系統屬性切換：-Dlog4j2.configurationFile=log4j2-prod.xml

效能調優清單

1. 啟用非同步日誌：JVM 參數 -DLog4jContextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector 或配置 <Async>
2. 關閉位置信息：includeLocation="false"，避免 StackWalker 開銷
3. 參數化日誌：log.info("msg {} {}", a, b) 而非 log.info("msg " + a + " " + b)
4. 適當級別：生產環境根級別 INFO，DEBUG 僅業務核心包
5. 滾動策略：按天 + 按大小雙觸發，壓縮舊文件 (.gz)，限制最大保留數
6. 緩衝區調優：高併發增大 bufferSize (8192/16384)，監控 AsyncQueueFull 丟棄事件

常見坑點

• 類路徑下存在多個 log4j2.xml → 載入順序不確定
• Log4j 1.x 配置 (log4j.properties) 不兼容 Log4j 2
• 非同步日誌丟失：JVM 關閉時調用 LogManager.shutdown() 刷新緩衝區
• Web 容器類加載器洩漏：ServletContextListener 中關閉 Log4j 上下文