MyBatis 常见日志组件集成详解

于 2025-10-07 10:35:46 发布
阅读量503 收藏 5
点赞数 8
CC 4.0 BY-SA版权
分类专栏： Mybatis 文章标签： mybatis
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_51288065/article/details/152617729

MyBatis 常见日志组件集成详解

1. MyBatis 日志系统概述

MyBatis 内置了日志接口，可以自动集成多种流行的日志框架。它会按以下顺序查找日志实现：

  1. SLF4J
  2. Apache Commons Logging
  3. Log4j 2
  4. Log4j
  5. JDK logging

2. 主流日志组件集成

2.1 SLF4J + Logback（推荐）

依赖配置
<!-- Maven 依赖 -->
<dependencies>
    <!-- SLF4J API -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-api</artifactId>
        <version>2.0.6</version>
    </dependency>
    
    <!-- Logback 实现 -->
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.4.5</version>
    </dependency>
    
    <!-- MyBatis -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.11</version>
    </dependency>
</dependencies>
Logback 配置文件
<!-- src/main/resources/logback.xml -->
<configuration>
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- MyBatis SQL 日志配置 -->
    <logger name="com.example.mapper" level="DEBUG" />
    
    <!-- 显示执行的SQL语句和参数 -->
    <logger name="java.sql.Connection" level="DEBUG"/>
    <logger name="java.sql.Statement" level="DEBUG"/>
    <logger name="java.sql.PreparedStatement" level="DEBUG"/>
    <logger name="java.sql.ResultSet" level="DEBUG"/>
    
    <!-- MyBatis 日志 -->
    <logger name="org.apache.ibatis" level="INFO"/>
    
    <!-- 根日志级别 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
    </root>
</configuration>

2.2 Log4j2

依赖配置
<!-- Maven 依赖 -->
<dependencies>
    <!-- Log4j2 -->
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-api</artifactId>
        <version>2.19.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
        <version>2.19.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-slf4j-impl</artifactId>
        <version>2.19.0</version>
    </dependency>
</dependencies>
Log4j2 配置文件
<!-- src/main/resources/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>
        
        <!-- 文件输出 -->
        <File name="MyFile" fileName="logs/mybatis.log">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </File>
    </Appenders>
    
    <Loggers>
        <!-- MyBatis Mapper 接口的SQL日志 -->
        <Logger name="com.example.mapper" level="DEBUG" additivity="false">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="MyFile"/>
        </Logger>
        
        <!-- SQL 执行日志 -->
        <Logger name="java.sql" level="DEBUG"/>
        <Logger name="org.apache.ibatis" level="INFO"/>
        
        <Root level="INFO">
            <AppenderRef ref="Console"/>
        </Root>
    </Loggers>
</Configuration>

2.3 Log4j

依赖配置
<!-- Maven 依赖 -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>
Log4j 配置文件
# src/main/resources/log4j.properties
# 根日志级别
log4j.rootLogger=INFO, stdout

# 控制台输出
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

# MyBatis SQL 日志
log4j.logger.com.example.mapper=DEBUG
log4j.logger.java.sql.Connection=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG

2.4 标准输出（StdOut）日志

在 MyBatis 配置中启用
<!-- mybatis-config.xml -->
<configuration>
    <settings>
        <!-- 使用标准输出日志 -->
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>
</configuration>

3. Spring Boot 中的日志配置

3.1 Spring Boot + Logback（默认）

# application.properties
# MyBatis Mapper 日志级别
logging.level.com.example.mapper=DEBUG

# SQL 相关日志
logging.level.java.sql.Connection=DEBUG
logging.level.java.sql.Statement=DEBUG
logging.level.java.sql.PreparedStatement=DEBUG

# MyBatis 框架日志
logging.level.org.mybatis=INFO
logging.level.org.apache.ibatis=INFO

# 日志文件输出
logging.file.name=logs/myapp.log
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} - %msg%n
logging.pattern.file=%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n

3.2 Spring Boot + Log4j2

<!-- pom.xml 中排除默认日志，引入 Log4j2 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

# application.yml
logging:
  level:
    com.example.mapper: DEBUG
    java.sql: DEBUG
  config: classpath:log4j2.xml

4. 日志输出效果示例

4.1 SQL 执行日志示例

2023-10-01 14:30:25.123 [http-nio-8080-exec-1] DEBUG c.e.m.UserMapper.selectById - ==>  Preparing: SELECT * FROM users WHERE id = ? 
2023-10-01 14:30:25.124 [http-nio-8080-exec-1] DEBUG c.e.m.UserMapper.selectById - ==> Parameters: 1(Long)
2023-10-01 14:30:25.126 [http-nio-8080-exec-1] DEBUG c.e.m.UserMapper.selectById - <==      Total: 1

4.2 详细 SQL 日志配置

<!-- 更详细的 SQL 日志配置 -->
<logger name="com.example.mapper" level="TRACE"/>
<logger name="java.sql" level="TRACE"/>

5. 高级日志配置技巧

5.1 按环境配置不同的日志级别

<!-- logback-spring.xml -->
<springProfile name="dev">
    <logger name="com.example.mapper" level="DEBUG"/>
    <logger name="java.sql" level="DEBUG"/>
</springProfile>

<springProfile name="prod">
    <logger name="com.example.mapper" level="WARN"/>
    <logger name="java.sql" level="WARN"/>
</springProfile>

5.2 SQL 执行时间监控

// 自定义拦截器监控 SQL 执行时间
@Intercepts({@Signature(type = StatementHandler.class, method = "query", args = {Statement.class, ResultHandler.class})})
public class SqlExecuteTimeInterceptor implements Interceptor {
    
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        long startTime = System.currentTimeMillis();
        try {
            return invocation.proceed();
        } finally {
            long endTime = System.currentTimeMillis();
            long executeTime = endTime - startTime;
            
            // 记录执行时间过长的 SQL
            if (executeTime > 1000) {
                Logger logger = LoggerFactory.getLogger("SLOW_SQL");
                logger.warn("Slow SQL detected, execution time: {}ms", executeTime);
            }
        }
    }
}

6. 常见问题与解决方案

6.1 日志冲突问题

<!-- 解决日志框架冲突 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

6.2 日志不输出问题排查

// 检查日志配置
public class LogConfigChecker {
    public static void main(String[] args) {
        // 检查所有日志框架
        LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();
        StatusPrinter.print(lc);
        
        // 测试日志输出
        Logger logger = LoggerFactory.getLogger(LogConfigChecker.class);
        logger.debug("Debug message");
        logger.info("Info message");
    }
}

6.3 生产环境日志配置

<!-- 生产环境日志配置 -->
<configuration>
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/mybatis.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/mybatis.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxHistory>30</maxHistory>
            <totalSizeCap>3GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 生产环境只记录 WARN 级别以上的日志 -->
    <root level="WARN">
        <appender-ref ref="FILE"/>
    </root>
    
    <!-- 但 MyBatis SQL 日志仍然记录 DEBUG -->
    <logger name="com.example.mapper" level="DEBUG"/>
</configuration>

7. 最佳实践总结

  1. 开发环境：使用 SLF4J + Logback，开启 DEBUG 级别 SQL 日志
  2. 生产环境：关闭 DEBUG 日志，使用文件输出，定期归档
  3. 日志级别：
    • Mapper 接口：DEBUG（查看 SQL）
    • java.sql 包：DEBUG（查看参数和结果）
    • org.apache.ibatis：INFO 或 WARN
  4. 性能考虑：生产环境避免输出过多 DEBUG 日志
  5. 安全考虑：确保日志中不记录敏感信息（如密码）

通过合理配置日志组件，可以有效地监控 MyBatis 的 SQL 执行情况，便于调试和性能优化。

MyBatis架构原理详解
m0_38033199的博客
11-24 3401
MyBatis 是 Java 生态中非常著名的一款 ORM 框架，目前在一线互联网大厂中应用广泛，Mybatis已经成为了一个必会框架。 Mybatis的功能架构分为三层：API接口层，数据处理层，基础支撑层
Java MyBatis 与 Spring 集成的完美方案
AI开发架构师
05-09 799
本文旨在为Java开发者提供一套完整的MyBatis与Spring框架集成方案，涵盖从基础配置到高级特性的全方位指导。两种框架集成的核心原理事务管理的实现机制性能优化策略实际项目中的最佳实践文章首先介绍基本概念和集成背景，然后深入技术实现细节，接着通过实际案例展示具体应用，最后讨论相关工具资源和未来发展趋势。MyBatis：一款优秀的持久层框架，支持定制化SQL、存储过程以及高级映射：轻量级的Java开发框架，提供全面的基础设施支持ORM。
MyBatis实战指南（八）MyBatis日志
2402_83322742的博客
06-29 2265
《MyBatis日志实战指南》详细解析了MyBatis日志系统的核心功能与配置方法。文章首先阐述了日志在开发、调试和生产环境中的关键作用，特别是SQL语句追踪和问题定位的价值。接着对比了SLF4J、Log4j、Log4j2等主流日志框架的优缺点，并提供了SLF4J+Logback的完整集成指南（含Maven依赖、配置文件和日志级别设置）。针对不同开发场景，文章还讲解了MyBatis原生配置与Spring Boot环境下日志的特殊配置方式。最后，从源码层面剖析了Log接口、LogFactory等核心组件的工作
提升开发效率的必备技能：Spring集成Mybatis和PageHelper详解
万维网连五洲，二进制写尽天下事，喜欢结识新伙伴寻找志同道合的朋友，欢迎一起探讨学习
08-25 2576
在这篇文章中，我们将深入探讨如何通过Spring集成Mybatis和PageHelper来提升你的开发效率。这就像是给你的代码注入了一股强大的动力，让你的项目像一辆跑车一样飞驰。但是，别忘了，驾驶技术再好，也需要一个好的导航系统。所以，让我们一起掌握这两个神器，让你的开发之旅更加顺畅无阻吧！
MyBatis详解
酷奇的博客
01-12 1575
框架英文FrameworkJava常用框架：SSM三大框架：Spring + SpringMVC + MyBatisSpringBootSpringBoot框架其实就是对通用代码的封装。提前写好了一对接口和类，我们可以在项目中直接引入这些接口和类（引入框架），基于框架开发可以大大提高开发效率。框架一般都以jar包形式存在。（jar包中有class文件以及各种配置文件等）MyBatis本质上就是对JDBC的封装，通过MyBatis完成CRUD。
MyBatis 核心配置文件详细内容详解
weixin_61635597的博客
05-30 1214
mybatis-confg.xml ，也就是MyBatis 的核心配置文件，主要配置连接数据库的信息等(**一般一个数据库，对应一个这个MyBatis 的核心配置文件)，同样的与之对应的通过mybatis-config.xml 核心配置文件'所创建的对象：SqlSession FactoryBuilder，SqlSessionFactory 也是一个数据库相对应上一个对象。 标签表示：配置环境（在MyBatis 的核心配置文件当中，可以配置多个），注意：一般s。
MyBatis 常用扩展组件详解（含代码示例）
爱的叹息的专栏
04-26 717
MyBatis 常用扩展组件详解（含代码示例）
SpringBoot中Log日志的集成详解
程序员小王的博客
12-26 3631
SpringBoot中Log日志的集成 一、日志的分类 1、名字分类 log4j ：log for java (因为for和4读音差不多，所以交log4j) logBack 日志说明 注意：springBoot默认集成了logback日志 2、日志分类 根日志：全局日志 rootLogger( springboot的日志级别：info) 子日志：包日志 logger 3、日志级别 OFF=》ERROR=》 WARNING=》INFO（springboot默认）=》DEBUG（mybatis默认级别）
Spring整合MyBatis详解
aa_hdkf_vg的博客
07-17 1344
企业级开发中，Spring（负责依赖管理和事务控制）与MyBatis（负责持久层操作）的整合是主流方案，本文我将详细讲解Spring整合MyBatis的完整流程，这种整合能充分发挥两者优势：Spring的IoC容器管理MyBatis的核心组件，AOP实现事务控制；MyBatis简化数据库操作。
springmvc与mybatis集成配置实例详解
09-01
在本文中，我们将深入探讨如何将Spring MVC与MyBatis集成，以便在Java Web开发中构建高效、可扩展的应用程序。这两个框架都是Java生态系统的支柱，Spring MVC作为强大的MVC框架，提供了优雅的控制层解决方案，而...
SpringMVC与MyBatis全注解集成开发详解
在进行SpringMVC和MyBatis集成开发时，首先需要了解它们的基本原理和配置方式。SpringMVC的工作原理主要依赖于DispatcherServlet，它将客户端请求分发给相应的Controller，并处理返回的Model和View。而MyBatis则通过...
Mybatis开发必备jar包详解
2. mybatis-spring-1.2.2.jar：这是 MyBatis 与 Spring 框架集成的组件，为 MyBatis 提供了与 Spring 框架更好的集成方式。它主要包括： - SqlSessionFactoryBean：这是 Spring 框架中用于配置 MyBatis ...
SpringMVC与Mybatis集成示例代码详解
### SpringMVC和Mybatis的集成使用示例 #### 概述 SpringMVC和Mybatis是Java开发中广泛使用的框架。SpringMVC是Spring框架的一部分，提供了构建Web应用程序的模型视图控制器（MVC）架构。Mybatis是一个持久层框架，...
Mybatis核心包压缩文件详解
- **slf4j-api-x.x.x.jar**：简单日志门面（Simple Logging Facade for Java），为 Java 日志系统提供一个简单的统一接口，MyBatis 使用它来记录日志。 - **optional-x.x.x.jar**：这是一个可选依赖库，MyBatis ...
MybatisPlus的LambdaQueryWrapper用法
2301_79693537的博客
08-21 6584
【代码】MybatisPlus的LambdaQueryWrapper用法。
opensearch-jvm-1.3.27.jar
10-06
opensearch-jvm-1.3.27.jar
marketplacedeployment-1.0.51-javadoc.jar
10-06
marketplacedeployment-1.0.51-javadoc.jar
s3-1.3.46-javadoc.jar
10-06
s3-1.3.46-javadoc.jar
proton-jvm-0.23.0-beta.jar
最新发布
10-07
proton-jvm-0.23.0-beta.jar
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

步行cgn

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值