Logback配置文件怎么寫

# Logback配置文件怎么寫

## 一、Logback簡介

Logback是Java社區中最流行的日志框架之一，作為Log4j的繼承者，由同一作者開發。它由三個模塊組成：
- logback-core（基礎模塊）
- logback-classic（實現了SLF4J API）
- logback-access（與Servlet容器集成）

### 1.1 Logback的優勢
- **性能提升**：比Log4j執行速度更快，內存占用更小
- **自動重載配置**：支持配置文件修改后自動重新加載
- **豐富的過濾功能**：提供多種靈活的過濾機制
- **上下文數據**：支持MDC（Mapped Diagnostic Context）
- **多種配置方式**：支持XML、Groovy和編程方式配置

## 二、基礎配置文件結構

Logback的標準配置文件名為`logback.xml`，需要放在classpath根目錄下?；窘Y構如下：

```xml
<configuration>
    <!-- 屬性定義 -->
    <property name="LOG_DIR" value="/var/logs/myapp" />
    
    <!-- Appender配置 -->
    <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>
    
    <!-- Logger配置 -->
    <logger name="com.example" level="DEBUG" />
    
    <!-- Root Logger配置 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
    </root>
</configuration>

三、詳細配置解析

3.1 屬性定義

可以在配置文件中定義變量，便于復用：

<!-- 簡單屬性 -->
<property name="LOG_DIR" value="/var/logs" />

<!-- 從系統環境變量獲取 -->
<property name="LOG_LEVEL" value="${LOG_LEVEL:-INFO}" />

<!-- 從配置文件獲取 -->
<property resource="application.properties" />

<!-- 使用條件判斷 -->
<if condition='property("os.name").contains("Windows")'>
    <then>
        <property name="LOG_DIR" value="C:/logs" />
    </then>
    <else>
        <property name="LOG_DIR" value="/var/logs" />
    </else>
</if>

3.2 Appender配置

Appender負責定義日志輸出目的地：

3.2.1 控制臺Appender

<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
    <target>System.out</target> <!-- 默認為System.err -->
</appender>

3.2.2 文件Appender

<appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <file>${LOG_DIR}/myapp.log</file>
    <append>true</append>
    <encoder>
        <pattern>%d %p %c{1.} [%t] %m%n</pattern>
    </encoder>
</appender>

3.2.3 滾動文件Appender

<appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_DIR}/app.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>${LOG_DIR}/app.%d{yyyy-MM-dd}.log</fileNamePattern>
        <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>

3.2.4 大小和時間的滾動策略

<appender name="ROLLING_SIZE_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_DIR}/size-roll.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
        <fileNamePattern>${LOG_DIR}/size-roll.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
        <maxFileSize>10MB</maxFileSize>
        <maxHistory>60</maxHistory>
        <totalSizeCap>2GB</totalSizeCap>
    </rollingPolicy>
    <encoder>
        <pattern>%d %p %c{1.} [%t] %m%n</pattern>
    </encoder>
</appender>

3.3 Encoder配置

Encoder負責日志事件的格式化：

<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
    <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    <charset>UTF-8</charset>
    <immediateFlush>true</immediateFlush>
</encoder>

常用模式符號： - %d - 日期時間 - %thread - 線程名 - %-5level - 日志級別（左對齊，固定5字符） - %logger - Logger名稱 - %msg - 日志消息 - %n - 換行符 - %X{key} - MDC中的值

3.4 Logger配置

Logger用于控制不同包的日志級別：

<!-- 特定包或類的Logger -->
<logger name="com.example.dao" level="DEBUG" additivity="false">
    <appender-ref ref="DAO_FILE" />
</logger>

<!-- 第三方庫的Logger -->
<logger name="org.hibernate" level="WARN" />
<logger name="org.springframework" level="INFO" />

3.5 Root Logger配置

Root Logger是所有Logger的父級：

<root level="INFO">
    <appender-ref ref="CONSOLE" />
    <appender-ref ref="FILE" />
</root>

四、高級配置技巧

4.1 條件配置

<if condition='property("env").equals("dev")'>
    <then>
        <root level="DEBUG">
            <appender-ref ref="CONSOLE" />
        </root>
    </then>
    <else>
        <root level="INFO">
            <appender-ref ref="FILE" />
        </root>
    </else>
</if>

4.2 異步日志

<appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
    <queueSize>512</queueSize>
    <discardingThreshold>0</discardingThreshold>
    <includeCallerData>true</includeCallerData>
    <appender-ref ref="FILE" />
</appender>

4.3 郵件通知

<appender name="EML" class="ch.qos.logback.classic.net.SMTPAppender">
    <smtpHost>smtp.example.com</smtpHost>
    <smtpPort>587</smtpPort>
    <username>user@example.com</username>
    <password>password</password>
    <to>admin@example.com</to>
    <from>noreply@example.com</from>
    <subject>ERROR: %logger{20} - %m</subject>
    <layout class="ch.qos.logback.classic.PatternLayout">
        <pattern>%d %-5level %logger{35} - %message%n</pattern>
    </layout>
    <cyclicBufferTracker class="ch.qos.logback.core.spi.CyclicBufferTracker">
        <bufferSize>10</bufferSize>
    </cyclicBufferTracker>
    <triggeringPolicy class="ch.qos.logback.classic.boolex.OnErrorEvaluator" />
</appender>

4.4 自定義轉換器

<conversionRule conversionWord="user" 
    converterClass="com.example.CustomConverter" />

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d %user %msg%n</pattern>
    </encoder>
</appender>

五、最佳實踐

5.1 多環境配置

<springProfile name="dev">
    <root level="DEBUG">
        <appender-ref ref="CONSOLE" />
    </root>
</springProfile>

<springProfile name="prod">
    <root level="INFO">
        <appender-ref ref="FILE" />
        <appender-ref ref="EML" />
    </root>
</springProfile>

5.2 日志文件管理

1. 按應用、日期、實例區分日志文件
2. 設置合理的滾動策略和保留期限
3. 對大文件使用壓縮
4. 監控日志目錄磁盤空間

5.3 性能優化

1. 生產環境避免使用immediateFlush="true"
2. 合理設置異步日志的隊列大小
3. 謹慎使用includeCallerData
4. 簡化復雜模式布局

六、常見問題解決

6.1 配置文件不生效

1. 檢查文件位置（classpath根目錄）
2. 檢查文件名（logback.xml或logback-test.xml）
3. 檢查是否有多個配置文件沖突

6.2 日志文件不滾動

1. 檢查fileNamePattern中的日期模式
2. 確保應用程序持續運行
3. 檢查文件權限

6.3 日志重復輸出

1. 檢查Logger的additivity屬性
2. 避免重復的appender-ref

七、完整配置示例

<configuration scan="true" scanPeriod="30 seconds">
    <!-- 環境變量 -->
    <property name="APP_NAME" value="my-application" />
    <property name="LOG_DIR" value="/var/log/${APP_NAME}" />
    
    <!-- 控制臺輸出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %highlight(%-5level) %cyan(%logger{36}) - %msg%n</pattern>
        </encoder>
    </appender>
    
    <!-- 主日志文件 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/app.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>50MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>5GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>
    
    <!-- 錯誤日志單獨輸出 -->
    <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/error.log</file>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERROR</level>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/error.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>90</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <!-- 異步日志 -->
    <appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
        <queueSize>1024</queueSize>
        <discardingThreshold>0</discardingThreshold>
        <appender-ref ref="FILE" />
    </appender>
    
    <!-- Logger配置 -->
    <logger name="com.example" level="DEBUG" />
    <logger name="org.springframework" level="WARN" />
    <logger name="org.hibernate.SQL" level="DEBUG" />
    
    <!-- Root Logger -->
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="ASYNC_FILE" />
        <appender-ref ref="ERROR_FILE" />
    </root>
</configuration>

八、總結

Logback提供了強大而靈活的日志配置能力，通過合理的配置可以： 1. 實現精細化的日志級別控制 2. 優化日志輸出性能 3. 方便地進行日志文件管理 4. 適應不同的運行環境需求

掌握Logback配置是Java開發者必備的技能，良好的日志實踐可以大大提高應用程序的可維護性和問題排查效率。 “`