前言

• 在上一篇博客中，我們深入剖析了 MyBatis 的緩存機制原理與實戰(zhàn)應(yīng)用。
• 作為 MyBatis 框架中另一重要的基礎(chǔ)設(shè)施，日志系統(tǒng)在項目開發(fā)、調(diào)試及運維階段承擔著關(guān)鍵作用 —— 它不僅能幫助開發(fā)者追蹤 SQL 執(zhí)行流程、定位異常問題，還能通過日志級別控制實現(xiàn)不同環(huán)境下的調(diào)試信息輸出管理。
• 從本文開始，我們將圍繞 MyBatis 日志模塊展開系統(tǒng)講解，涵蓋 日志框架集成（Log4j/SLF4J 等）、配置方式、源碼解析及性能優(yōu)化 等核心內(nèi)容，幫助讀者全面掌握 MyBatis 日志體系的技術(shù)細節(jié)與最佳實踐。

一、為什么需要日志？

舉個生活中的例子：你網(wǎng)購收到商品發(fā)現(xiàn)有問題，打電話給客服時，客服需要查看訂單記錄（日志）才能定位問題。MyBatis的日志也是一樣的道理：

• 開發(fā)階段：打印SQL語句和參數(shù)，幫你確認寫的SQL是否正確（比如有沒有拼錯表名、where條件是否正確）
• 調(diào)試階段：記錄異常信息（比如數(shù)據(jù)庫連接失敗、參數(shù)類型錯誤），快速定位報錯位置
• 生產(chǎn)階段：通過控制日志級別，只記錄重要信息（比如錯誤日志），避免無關(guān)信息干擾

最常用的場景：當你發(fā)現(xiàn)查詢結(jié)果不對時，第一時間打開日志看看實際執(zhí)行的SQL是什么，90%的問題都能通過對比SQL找到原因！

二、日志框架怎么選？

MyBatis本身不自帶日志實現(xiàn)，需要集成第三方日志框架。

• 常見的框架有這幾種。

1. 手把手教你集成（以最常用的SLF4J+Logback為例）

步驟1：添加依賴（Maven項目）

<!-- SLF4J接口 -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>2.0.7</version>
</dependency>
<!-- Logback實現(xiàn) -->
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.4.13</version>
</dependency>

步驟2：在MyBatis配置文件中開啟日志

在mybatis-config.xml中添加：

<settings>
    <!-- 設(shè)置日志工廠為SLF4J -->
    <setting name="logImpl" value="SLF4J"/>
</settings>

步驟3：配置Logback日志文件

在src/main/resources目錄下新建logback.xml，核心配置如下（重點看注釋）：

<configuration>
    <!-- 定義日志輸出格式 -->
    <pattern name="simplePattern">%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{50} - %msg%n</pattern>
    <!-- 控制臺輸出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${simplePattern}</pattern>
        </encoder>
    </appender>
    <!-- 重點：配置MyBatis日志輸出 -->
    <logger name="org.apache.ibatis" level="DEBUG"/> <!-- 輸出MyBatis自身日志 -->
    <logger name="com.yourcompany.mapper" level="DEBUG"/> <!-- 輸出你的Mapper接口日志 -->
    <root level="INFO"> <!-- 全局日志級別，優(yōu)先級低于上面的logger -->
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

三、配置方式詳解

1. MyBatis自身的日志配置

在mybatis-config.xml中，通過<settings>標簽配置：

• logImpl：指定使用的日志框架（可選值：SLF4J、LOG4J、LOG4J2、JUL、STDOUT_LOGGING、NO_LOGGING）

  <!-- 示例：使用Log4j2 -->
  <setting name="logImpl" value="LOG4J2"/>

• lazyLoadingEnabled和aggressiveLazyLoading：這兩個和延遲加載相關(guān)的日志，新手暫時不用管，保持默認即可。

2. 日志級別控制

日志級別從低到高依次是：DEBUG < INFO < WARN < ERROR，級別越高，輸出的內(nèi)容越少。

• 開發(fā)階段：建議設(shè)為DEBUG，能看到完整的SQL語句和參數(shù)（比如：==> Preparing: SELECT * FROM user WHERE id=?）
• 生產(chǎn)階段：設(shè)為ERROR或WARN，只記錄錯誤和警告，避免日志文件過大

3. Spring Boot中怎么配？

如果你用Spring Boot，不需要單獨寫MyBatis配置文件，直接在application.properties中配置：

# 開啟MyBatis日志
mybatis.configuration.log-impl=org.apache.ibatis.logging.slf4j.Slf4jImpl
# 配置具體Mapper的日志級別（比如只打印UserMapper的DEBUG日志）
logging.level.com.yourcompany.mapper.UserMapper=DEBUG

四、源碼解析：搞懂MyBatis日志底層邏輯

如果你對底層原理好奇，可以簡單了解這幾個核心類，不用記代碼，知道它們的關(guān)系就行：

1. 日志接口 Log

MyBatis定義了一個統(tǒng)一的日志接口Log，所有日志框架都要實現(xiàn)這個接口。比如Slf4jImpl就是SLF4J的實現(xiàn)類，Log4jImpl是Log4j的實現(xiàn)類。

2. 日志工廠LogFactory

它就像一個"工廠"，根據(jù)你配置的logImpl，生產(chǎn)對應(yīng)的日志對象。比如你配置了SLF4J，它就會創(chuàng)建Slf4jImpl對象。

3. 自動檢測機制

如果你的項目中同時存在多個日志框架（比如同時有Log4j和SLF4J），MyBatis會按以下順序自動選擇：

SLF4J → LOG4J2 → LOG4J → JUL → STDOUT（控制臺輸出）→ NO_LOGGING（無日志）

所以建議只保留一個日志框架，避免沖突。

以上就是這篇博客的全部內(nèi)容，下一篇我們將繼續(xù)探索MyBatis的更多精彩內(nèi)容。

到此這篇關(guān)于MyBatis實戰(zhàn)指南之MyBatis日志詳解的文章就介紹到這了,更多相關(guān)MyBatis日志內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論