在MyBatis中開啟SQL日志的具體步驟
更新時間：2025年11月21日 09:19:14 作者：chxii
文章詳細介紹了在原生MyBatis和SpringBoot中開啟MyBatis日志的具體步驟,包括引入日志依賴、配置日志文件和設置日志級別,文章還提供了對比總結和常見問題解答,幫助讀者更好地理解和配置MyBatis日志,需要的朋友可以參考下
一、單獨使用 MyBatis（原生）如何開啟日志
步驟 1：引入日志依賴（以 Log4j2 為例）
MyBatis 本身不包含日志實現(xiàn)，需自行引入。推薦使用 Log4j2 或 SLF4J + Logback。
Maven 依賴（Log4j2）：
<dependencies>
<!-- MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.13</version>
</dependency>
<!-- MySQL 驅(qū)動 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.33</version>
</dependency>
<!-- Log4j2 核心 -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.20.0</version>
</dependency>
<!-- Log4j2 API -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.20.0</version>
</dependency>
</dependencies>不要引入
slf4j相關依賴，避免日志橋接沖突（除非你明確使用 SLF4J）。
步驟 2：配置日志文件（log4j2.xml）
在 src/main/resources 下創(chuàng)建 log4j2.xml：
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<!-- 關鍵：將你的 Mapper 接口所在包設為 DEBUG 級別 -->
<Logger name="com.example.mapper" level="debug" additivity="false">
<AppenderRef ref="Console"/>
</Logger>
<Root level="info">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>? name="com.example.mapper" 必須替換為你實際的 Mapper 接口包路徑！
步驟 3：確保 MyBatis 能識別日志實現(xiàn)
MyBatis 會自動探測已引入的日志框架。只要正確引入了 Log4j2 依賴，無需額外配置。
可選：強制指定日志實現(xiàn)（一般不需要）
System.setProperty("org.apache.ibatis.logging.LogFactory",
"org.apache.ibatis.logging.log4j2.Log4j2Impl");效果驗證
運行以下代碼：
try (SqlSession session = MyBatisUtil.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.findById(1);
System.out.println(user);
}控制臺將輸出：
15:30:22.123 [main] DEBUG c.e.m.UserMapper.findById - ==> Preparing: SELECT id, username, email FROM user WHERE id = ? 15:30:22.150 [main] DEBUG c.e.m.UserMapper.findById - ==> Parameters: 1(Integer) 15:30:22.180 [main] DEBUG c.e.m.UserMapper.findById - <== Total: 1
二、Spring Boot 中如何開啟 MyBatis 日志
Spring Boot 默認使用 SLF4J + Logback，配置極其簡單。
步驟 1：確認依賴
確保已引入 mybatis-spring-boot-starter：
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>3.0.3</version>
</dependency>該 starter 已自動引入 SLF4J 和 Spring Boot 日志支持。
步驟 2：配置 application.yml
在 application.yml 中設置 Mapper 接口包的日志級別為 debug：
logging:
level:
# 替換為你的 Mapper 接口所在包
com.example.mapper: debug? 無需配置 logback.xml，除非有特殊格式需求。
效果驗證
調(diào)用 Service 方法：
@RestController
public class UserController {
@Autowired
private UserMapper userMapper;
@GetMapping("/user/{id}")
public User getUser(@PathVariable Integer id) {
return userMapper.findById(id); // 自動輸出 SQL 日志
}
}控制臺輸出：
2025-11-20 15:40:00.123 DEBUG 12345 --- [nio-8080-exec-1] c.e.m.UserMapper.findById : ==> Preparing: SELECT id, username, email FROM user WHERE id = ? 2025-11-20 15:40:00.150 DEBUG 12345 --- [nio-8080-exec-1] c.e.m.UserMapper.findById : ==> Parameters: 1(Integer) 2025-11-20 15:40:00.180 DEBUG 12345 --- [nio-8080-exec-1] c.e.m.UserMapper.findById : <== Total: 1
三、對比總結
| 項目 | 原生 MyBatis | Spring Boot + MyBatis |
|---|---|---|
| 日志框架 | 需手動引入（Log4j2/Logback） | 自動使用 SLF4J + Logback |
| 配置方式 | 編寫 log4j2.xml 或 logback.xml | 在 application.yml 中設置 logging.level |
| 關鍵配置項 | <Logger name="mapper包路徑" level="debug"> | logging.level.com.your.mapper=debug |
| 是否需要額外代碼 | 否（依賴自動探測） | 否 |
| 推薦場景 | 獨立工具、非 Spring 項目 | Web 應用、微服務 |
四、常見問題
Q1：為什么設置了日志級別還是看不到 SQL？
- 檢查包路徑是否完全匹配（區(qū)分大小寫）
- 確認是 Mapper 接口的包路徑，不是 XML 文件路徑
- 原生項目檢查是否引入了正確的日志實現(xiàn)依賴
Q2：能否只打印 SQL 不打印結果？
可以，降低 ResultSetHandler 日志級別：
# Spring Boot
logging:
level:
com.example.mapper: debug
org.apache.ibatis.executor.resultset: warnQ3：生產(chǎn)環(huán)境是否應關閉？
強烈建議關閉：
# application-prod.yml
logging:
level:
com.example.mapper: info # 或 warn/error避免性能損耗和敏感信息泄露。
結語
無論是原生 MyBatis 還是 Spring Boot 集成，開啟 SQL 日志的核心都是：將 Mapper 接口所在包的日志級別設為 DEBUG。
以上就是在MyBatis中開啟SQL日志的具體步驟的詳細內(nèi)容，更多關于MyBatis開啟SQL日志的資料請關注腳本之家其它相關文章！
相關文章
Java中@Autowired和@Resource區(qū)別
本文主要介紹了Java中@Autowired和@Resource區(qū)別，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-06-06
詳解SpringBoot配置devtools實現(xiàn)熱部署
本篇文章主要介紹了詳解SpringBoot配置devtools實現(xiàn)熱部署 ，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-05-05
本文非常詳細的講解了java反射具體的內(nèi)容以及使用，java反射在現(xiàn)今的使用中很頻繁，希望此文可以幫大家解答疑惑，可以幫助大家理解2021-11-11
這篇文章主要介紹了如何修改json字符串中某個key對應的value值操作，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-11-11
ruoyi-springboot框架新增模塊調(diào)接口報404的解決方案
這篇文章主要介紹了ruoyi-springboot框架新增模塊調(diào)接口報404的解決方案,文中通過代碼示例給大家講解的非常詳細,對大家的學習或工作有一定的幫助,需要的朋友可以參考下2024-03-03
如何使用Mockito調(diào)用靜態(tài)方法和void方法
這篇文章主要介紹了如何使用Mockito調(diào)用靜態(tài)方法和void方法的操作，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-07-07
本文主要介紹了SpringBoot整合Lombok及常見問題解決，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2022-04-04
這篇文章主要介紹了Spring?Cloud?Eureka?搭建?&?集群方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-03-03
Mybatis是一個半自動ORM（Object Relational Mapping）框架,它可以簡化數(shù)據(jù)庫編程,讓開發(fā)者更專注于SQL本身,本文給大家介紹Spring Mybatis 基本使用過程,感興趣的朋友跟隨小編一起看看吧2024-09-09
JVM statistics Monitoring,用于監(jiān)視虛擬機運行時狀態(tài)信息的命令,它可以顯示出虛擬機進程中的類裝載、內(nèi)存、垃圾收集、JIT編譯等運行數(shù)據(jù),這篇文章主要介紹了JVM調(diào)試命令與調(diào)試工具,需要的朋友可以參考下2023-10-10