MyBatis集成Logback日志全攻略

MyBatis集成Logback日志框架的完整步骤如下:

1. 添加依赖

在Maven项目的pom.xml中添加Logback和SLF4J依赖:

xml 复制代码
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.13</version>
</dependency>

注意:Spring Boot项目默认已包含Logback,无需额外添加。

2. MyBatis日志配置

在mybatis-config.xml中指定日志实现(可选):

xml 复制代码
<settings>
    <setting name="logImpl" value="SLF4J"/>
</settings>

若不配置,MyBatis会自动检测可用的日志框架。

3. 创建logback.xml配置文件

在resources目录下创建logback.xml,基础配置示例:

xml 复制代码
<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="60 seconds">
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 单独配置MyBatis的SQL日志 -->
    <logger name="org.mybatis" level="DEBUG" additivity="false">
        <appender-ref ref="CONSOLE"/>
    </logger>

    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

关键配置说明:

  • name="org.mybatis" 捕获MyBatis日志
  • level="DEBUG" 显示SQL语句和参数
  • 彩色日志需添加Spring Boot的ColorConverter

4. Spring Boot集成(可选)

在application.yml中添加:

yaml 复制代码
logging:
  level:
    com.yourpackage.mapper: DEBUG
mybatis:
  configuration:
    log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl

此配置会覆盖mybatis-config.xml的设置。

常见问题解决

  1. 日志冲突:排除Lombok中的logback依赖

    xml 复制代码
    <exclusions>
        <exclusion>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
        </exclusion>
    </exclusions>
  2. 日志文件分离:通过不同appender将业务日志和SQL日志输出到不同文件

  3. 日志级别:生产环境建议将MyBatis日志设为DEBUG,root日志设为WARN

高级配置建议

  1. 按包区分日志:为不同DAO包设置不同日志级别

    xml 复制代码
    <logger name="com.example.user.mapper" level="TRACE"/>
    <logger name="com.example.order.mapper" level="DEBUG"/>
  2. 日志滚动策略:添加TimeBasedRollingPolicy避免日志文件过大

    xml 复制代码
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>logs/sql-%d{yyyy-MM-dd}.log</fileNamePattern>
        <maxHistory>30</maxHistory>
    </rollingPolicy>
  3. 彩色日志:集成spring-boot-starter-logging实现终端彩色输出

通过以上配置,即可实现MyBatis与Logback的完整集成,既能查看详细的SQL执行信息,又能保持日志系统的统一管理。

相关推荐
青衫码上行11 小时前
【Java Web学习 | 第1篇】前端 - HTML
java·前端·学习
阿金要当大魔王~~12 小时前
uniapp img 动态渲染 的几种用法
java·服务器·前端·1024程序员节
摸鱼的老谭12 小时前
Java 25 中的最佳新特性
java·1024程序员节
lang2015092812 小时前
Spring Boot健康检查全解析
java·spring boot·后端
我是华为OD~HR~栗栗呀13 小时前
华为OD-Java面经-21届考研
java·c++·后端·python·华为od·华为·面试
考虑考虑13 小时前
流收集器
java·后端·java ee
今天背单词了吗98013 小时前
Spring Boot+RabbitMQ 实战:4 种交换机模式(Work/Fanout/Direct/Topic)保姆级实现
java·spring·中间件·rabbitmq·1024程序员节
九皇叔叔14 小时前
Java循环结构全解析:从基础用法到性能优化
java·开发语言·性能优化
流星52112214 小时前
GC 如何判断对象该回收?从可达性分析到回收时机的关键逻辑
java·jvm·笔记·学习·算法
csdn_aspnet14 小时前
Java 圆台体积和表面积计算程序(Program for Volume and Surface area of Frustum of Cone)
java