MyBatis实战指南（八）MyBatis日志

前言

• 在上一篇博客中，我们深入剖析了 MyBatis 的缓存机制原理与实战应用。
• 作为 MyBatis 框架中另一重要的基础设施，日志系统在项目开发、调试及运维阶段承担着关键作用 —— 它不仅能帮助开发者追踪 SQL 执行流程、定位异常问题，还能通过日志级别控制实现不同环境下的调试信息输出管理。
• 从本文开始，我们将围绕 MyBatis 日志模块展开系统讲解，涵盖 日志框架集成（Log4j/SLF4J 等）、配置方式、源码解析及性能优化 等核心内容，帮助读者全面掌握 MyBatis 日志体系的技术细节与最佳实践。

我的个人主页，欢迎来阅读我的其他文章
https://blog.csdn.net/2402_83322742?spm=1011.2415.3001.5343
我的MyBatis实战指南知识文章专栏
欢迎来阅读指出不足
https://blog.csdn.net/2402_83322742/category_12969707.html?spm=1001.2014.3001.5482

一、为什么需要日志？

举个生活中的例子：你网购收到商品发现有问题，打电话给客服时，客服需要查看订单记录（日志）才能定位问题。MyBatis的日志也是一样的道理：

• 开发阶段：打印SQL语句和参数，帮你确认写的SQL是否正确（比如有没有拼错表名、where条件是否正确）
• 调试阶段：记录异常信息（比如数据库连接失败、参数类型错误），快速定位报错位置
• 生产阶段：通过控制日志级别，只记录重要信息（比如错误日志），避免无关信息干扰

最常用的场景：当你发现查询结果不对时，第一时间打开日志看看实际执行的SQL是什么，90%的问题都能通过对比SQL找到原因！

二、日志框架怎么选？

MyBatis本身不自带日志实现，需要集成第三方日志框架。

• 常见的框架有这几种。

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

步骤1：添加依赖（Maven项目）

<!-- SLF4J接口 -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>2.0.7</version>
</dependency>
<!-- Logback实现 -->
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.4.13</version>
</dependency>

步骤2：在MyBatis配置文件中开启日志

在mybatis-config.xml中添加：

<settings>
    <!-- 设置日志工厂为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"> <!-- 全局日志级别，优先级低于上面的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：这两个和延迟加载相关的日志，新手暂时不用管，保持默认即可。

2. 日志级别控制

日志级别从低到高依次是：DEBUG < INFO < WARN < ERROR，级别越高，输出的内容越少。

• 开发阶段：建议设为DEBUG，能看到完整的SQL语句和参数（比如：==> Preparing: SELECT * FROM user WHERE id=?）
• 生产阶段：设为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日志底层逻辑

如果你对底层原理好奇，可以简单了解这几个核心类，不用记代码，知道它们的关系就行：

1. 日志接口 Log

MyBatis定义了一个统一的日志接口Log，所有日志框架都要实现这个接口。比如Slf4jImpl就是SLF4J的实现类，Log4jImpl是Log4j的实现类。

2. 日志工厂LogFactory

它就像一个"工厂"，根据你配置的logImpl，生产对应的日志对象。比如你配置了SLF4J，它就会创建Slf4jImpl对象。

3. 自动检测机制

如果你的项目中同时存在多个日志框架（比如同时有Log4j和SLF4J），MyBatis会按以下顺序自动选择：

SLF4J → LOG4J2 → LOG4J → JUL → STDOUT（控制台输出）→ NO_LOGGING（无日志）

所以建议只保留一个日志框架，避免冲突。

以上就是这篇博客的全部内容，下一篇我们将继续探索MyBatis的更多精彩内容。

我的个人主页，欢迎来阅读我的其他文章
https://blog.csdn.net/2402_83322742?spm=1011.2415.3001.5343
我的MyBatis实战指南知识文章专栏
欢迎来阅读指出不足
https://blog.csdn.net/2402_83322742/category_12969707.html?spm=1001.2014.3001.5482