MyBatis实战指南（八）MyBatis日志_mybatis配置日志

MyBatis实战指南（八）MyBatis日志

• 前言
• 一、为什么需要日志？
• 二、日志框架怎么选？
• • 1. 手把手教你集成（以最常用的SLF4J+Logback为例）
  • 步骤1：添加依赖（Maven项目）
  • 步骤2：在MyBatis配置文件中开启日志
  • 步骤3：配置Logback日志文件
• 三、配置方式详解
• • 1. MyBatis自身的日志配置
  • 2. 日志级别控制
  • 3. Spring Boot中怎么配？
• 四、源码解析：搞懂MyBatis日志底层逻辑
• • 1. 日志接口 Log
  • 2. 日志工厂LogFactory
  • 3. 自动检测机制

---

前言

• 在上一篇博客中，我们深入剖析了 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本身不自带日志实现，需要集成第三方日志框架。

• 常见的框架有这几种。

框架名称 优点 缺点 适合场景 SLF4J 统一日志接口，支持多种实现（如Logback） 不能单独使用，必须搭配具体实现 新项目首选，推荐搭配Logback Log4j 老牌框架，配置简单 性能一般，新版本Log4j2已发布 兼容旧项目 Log4j2 性能更好，支持异步日志 配置比Log4j复杂一点 对性能要求高的项目 Java自带JUL 无需额外依赖 功能简单，配置不够灵活 极简项目或临时调试

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

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

<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>2.0.7</version></dependency><dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> <version>1.4.13</version></dependency>

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

在mybatis-config.xml中添加：

<settings>  <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>  <logger name=\"org.apache.ibatis\" level=\"DEBUG\"/>  <logger name=\"com.yourcompany.mapper\" level=\"DEBUG\"/>  <root level=\"INFO\">  <appender-ref ref=\"CONSOLE\"/> </root></configuration>

三、配置方式详解

1. MyBatis自身的日志配置

在mybatis-config.xml中，通过标签配置：

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

  <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

非常感谢您的阅读，喜欢的话记得三连哦