在 Spring Boot 中使用 Logback 作為日志框架是開發中的常見需求，因其高性能和靈活配置而廣受青睞。以下是詳細實踐指南，結合了配置方法、代碼示例及最佳實踐：

---

🔧 一、依賴配置

Spring Boot 默認集成了 Logback，無需手動添加依賴：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId> <!-- 默認包含 logging 模塊 -->
</dependency>

若需切換至 Log4j2，需排除默認日志依賴并引入 Log4j2：

更多配置細節可參考：Spring Boot 日志系統配置（上）、Logback 配置文件詳解。

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><exclusions><exclusion><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-logging</artifactId></exclusion></exclusions>
</dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

---

?? 二、配置方式

1. 基礎配置（application.yml/properties）

適用于簡單場景，如設置日志級別和輸出路徑：

logging:level:root: INFOcom.example.service: DEBUG  # 包級自定義日志級別file:name: logs/app.log         # 指定日志文件路徑pattern:console: "%d{yyyy-MM-dd} [%thread] %-5level %logger{36} - %msg%n"

• 注意：logging.file.name 和 logging.file.path 不可同時使用。

2. 高級配置（logback-spring.xml）

創建 src/main/resources/logback-spring.xml，支持復雜策略如滾動日志、環境隔離：

<configuration><!-- 動態讀取 Spring 應用名 --><springProperty name="app.name" source="spring.application.name" default="app"/><property name="LOG_PATH" value="./logs/${app.name}"/><!-- 控制臺輸出 --><appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %highlight(%-5level) %cyan(%logger{36}) - %msg%n</pattern></encoder></appender><!-- 按天滾動日志文件 --><appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>${LOG_PATH}/app.log</file><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><fileNamePattern>${LOG_PATH}/app-%d{yyyy-MM-dd}.%i.log</fileNamePattern><maxHistory>30</maxHistory> <!-- 保留30天 --><maxFileSize>10MB</maxFileSize> <!-- 單文件最大10MB --></rollingPolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><!-- 環境隔離配置 --><springProfile name="dev"><root level="DEBUG"> <!-- 開發環境啟用DEBUG --><appender-ref ref="CONSOLE"/><appender-ref ref="FILE"/></root></springProfile><springProfile name="prod"><root level="INFO"> <!-- 生產環境僅INFO及以上 --><appender-ref ref="FILE"/></root></springProfile>
</configuration>

• 關鍵特性：
  ? 動態屬性：<springProperty> 讀取 Spring 配置
  ? 環境隔離：<springProfile> 按環境（dev/prod）切換配置
  ? 滾動策略：避免日志文件過大（按時間/大小分割）

---

💻 三、代碼中使用日志

通過 SLF4J 接口記錄日志，避免直接依賴 Logback：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;@RestController
public class UserController {private static final Logger logger = LoggerFactory.getLogger(UserController.class);@GetMapping("/users")public List<User> getUsers() {logger.debug("查詢用戶列表開始"); // DEBUG級別僅在開發環境輸出logger.info("請求處理中...");try {// 業務邏輯} catch (Exception e) {logger.error("用戶查詢失敗", e); // 記錄異常堆棧}return userList;}
}

• 最佳實踐：
  🔹 使用 {} 占位符避免字符串拼接開銷：logger.info("用戶ID: {}", userId);
  🔹 異常日志需傳遞異常對象：logger.error("錯誤描述", exception)

---

🚀 四、高級特性

1. 異步日志
   提升性能，減少 I/O 阻塞：

   <appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender"><queueSize>500</queueSize> <!-- 隊列容量 --><discardingThreshold>0</discardingThreshold> <!-- 不丟棄日志 --><appender-ref ref="FILE"/>
   </appender>
   

2. MDC（診斷上下文）
   添加請求 ID 實現鏈路追蹤：

   MDC.put("requestId", UUID.randomUUID().toString());
   logger.info("訂單創建");
   MDC.remove("requestId");
   

   配置 logback-spring.xml 輸出 MDC 值：

   <pattern>%d{yyyy-MM-dd} [%X{requestId}] %msg%n</pattern>
   

3. 敏感信息脫敏
   自定義轉換器屏蔽敏感數據（如手機號、密碼）。

---

?? 五、常見問題解決

問題	原因與解決方案
日志文件未生成	檢查路徑權限或配置沖突（logging.file.name vs logging.file.path）
日志級別不生效	確保配置文件中無沖突的 <logger> 定義，或檢查依賴沖突（如多個日志框架共存）
配置變更未加載	開啟熱更新：<configuration scan="true" scanPeriod="30 seconds">
生產環境日志過大	啟用滾動策略 + 異步寫入，定期清理歷史日志（maxHistory）

---

💎 最佳實踐總結

1. 配置規范：優先用 logback-spring.xml（非 logback.xml）以支持 Spring 擴展；
2. 環境適配：開發環境輸出到控制臺 + DEBUG 級別，生產環境僅文件輸出 + INFO 級別；
3. 性能優化：生產環境啟用異步日志與滾動壓縮策略；
4. 日志治理：敏感信息脫敏、定期清理舊日志（maxHistory）、監控日志文件大小。