### Spring Boot 中整合
MyBatis 并
开启日志的
配置方法
#### 1. 引入必要的依赖
为了在 Spring Boot 项目中使用
MyBatis，需要引入 `
mybatis-spring-boot-starter` 作为核心依赖。如果计划使用 Logback 或 Log4j2 来管理
日志，则无需额外引入这些库，因为它们已经是 Spring Boot 默认支持的
日志框架之一。
以下是 Maven 的依赖
配置示例：
```xml
<dependency>
<groupId>org.
mybatis.spring.boot</groupId>
<artifactId>
mybatis-spring-boot-starter</artifactId>
<version>2.3.0</version>
</dependency>
<!-- 如果需要使用 Log4j2 替代默认的 Logback -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
```
注意：当引入 `spring-boot-starter-log4j2` 后，默认的
日志框架 Logback 将被替换为 Log4j2[^1]。
---
#### 2.
配置 application.properties 文件
在 `application.properties` 文件中，可以通过以下属性启用 SQL 执行
日志记录功能，并指定
日志级别。
##### 使用 Logback 记录
MyBatis 日志
```properties
# 设置
MyBatis 的
日志实现为 SLF4J (默认值)
mybatis.configuration.log-impl=org.apache.ibatis.logging.slf4j.Slf4jImpl
#
开启 SQL 调试
日志
logging.level.com.example.mapper=
DEBUG
```
其中，`com.example.mapper` 是 Mapper 接口所在的包名，请根据实际项目的结构调整该路径。
---
#### 3. 自定义 Logback
配置文件
如果希望进一步自定义
日志输出格式或存储位置，可以在 `src/main/resources/` 下创建 `logback-spring.xml` 文件。以下是一个简单的示例：
```xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<!-- 定义控制台输出 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<!-- 定义文件输出 -->
<appender name="FILE" class="ch.qos.logback.core.FileAppender">
<file>logs/
mybatis.log</file>
<append>true</append>
<encoder>
<pattern>%date %level [%thread] %logger{10} [%file:%line] %msg%n</pattern>
</encoder>
</appender>
<!--
配置 Logger -->
<logger name="com.example.mapper" level="
DEBUG" additivity="false">
<appender-ref ref="STDOUT"/>
<appender-ref ref="FILE"/>
</logger>
<!-- Root logger -->
<root level="INFO">
<appender-ref ref="STDOUT"/>
</root>
</configuration>
```
此
配置将使所有的 Mapper 类
日志以
DEBUG 级别输出至控制台和文件中[^3]。
---
#### 4. 使用 Log4j2 进行
日志管理
如果选择使用 Log4j2 替代 Logback，则需编写对应的 `log4j2.xml`
配置文件。以下是一个基础示例：
```xml
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<!-- 控制台输出 -->
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
<!-- 文件输出 -->
<File name="
MyBatisLogFile" fileName="logs/
mybatis.log" append="true">
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</File>
</Appenders>
<Loggers>
<!-- 针对
MyBatis 的
日志 -->
<Logger name="com.example.mapper" level="
debug" additivity="false">
<AppenderRef ref="Console"/>
<AppenderRef ref="
MyBatisLogFile"/>
</Logger>
<!-- 根
日志 -->
<Root level="info">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>
```
在此
配置下，Mapper 层的
日志将以
DEBUG 级别分别写入控制台和文件[^4]。
---
#### 5. 测试
日志输出
完成以上
配置后，在任意 Mapper 方法上调用时，SQL 查询语句及其参数将会被打印出来。例如：
```java
@Select("SELECT * FROM user WHERE id = #{id}")
User findById(@Param("id") Long id);
```
运行程序后，可以看到如下
日志输出：
```
2023-09-27 10:00:00 [main]
DEBUG com.example.mapper.UserMapper - Preparing: SELECT * FROM user WHERE id = ?
2023-09-27 10:00:00 [main]
DEBUG com.example.mapper.UserMapper - Parameters: 1(Long)
2023-09-27 10:00:00 [main]
DEBUG com.example.mapper.UserMapper - ResultSet: ...
```
---
### 总结
通过上述步骤，可以成功在 Spring Boot 项目中整合
MyBatis 并
开启日志功能。无论是使用 Logback 还是 Log4j2，都可以灵活地定制
日志输出行为，满足不同的开发需求。
本文介绍如何在application.yml文件中设置日志级别，具体到com.spot.cn.mapper包下的日志将被调整为debug级别，这对于调试和监控特定模块的运行情况非常有用。
扫一扫
1223
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
