MyBatis日志配置与优化全攻略

MyBatis的日志记录分析主要通过集成日志框架实现，以下是具体方法和配置步骤：

一、日志框架选择与配置

1. 支持的日志框架
   MyBatis支持多种日志实现，包括SLF4J、Log4j、Log4j2、JDK Logging等，默认按顺序检测可用框架。推荐使用SLF4J+Logback组合，因其性能优越且与Spring Boot生态兼容性好。

2. 依赖配置
   以Maven项目为例，需添加日志框架依赖（如SLF4J和Logback）：

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

二、MyBatis日志级别与输出控制

1. 全局日志配置
   在mybatis-config.xml中指定日志实现：

   <configuration>
       <settings>
           <setting name="logImpl" value="SLF4J"/>
       </settings>
   </configuration>
   

   若不配置，MyBatis会自动检测可用框架。

2. 日志级别设置
   通过日志框架配置文件（如logback.xml）控制输出粒度：

   <configuration>
       <logger name="org.mybatis" level="DEBUG"/>
       <root level="INFO">
           <appender-ref ref="STDOUT"/>
       </root>
   </configuration>
   

   DEBUG级别可输出SQL语句及参数，INFO仅显示执行时间。

三、SQL日志打印优化

1. 自定义拦截器
   实现Interceptor接口，通过BoundSql获取完整SQL并替换占位符，记录执行时间。示例插件类需标注@Intercepts注解并绑定到Executor方法。

2. 插件工具
   使用第三方插件如MyBatisLogs（IDEA插件），可实时高亮显示SQL及参数，无需手动解析日志。

四、日志分析场景

1. 性能调优
   通过慢查询日志定位耗时SQL，结合执行计划分析优化索引或查询逻辑。

2. 调试与排查

   • 缓存问题：日志可显示缓存命中情况，辅助解决数据一致性问题。
   • 参数错误：DEBUG级别日志会输出绑定参数，便于验证SQL拼接正确性。

五、注意事项

1. 日志框架冲突
   若部署环境自带日志实现（如WebSphere的Commons Logging），需在MyBatis配置中强制指定日志框架。

2. 生产环境配置
   建议生产环境使用INFO级别以减少日志量，开发环境可启用DEBUG。

通过合理配置日志框架和级别，结合拦截器或插件工具，可以高效分析MyBatis的SQL执行过程，提升开发和运维效率。