MyBatis-Flex引入后为何不打印SQL日志？配置是否正确缺失？

Question

在使用MyBatis-Flex时，若发现SQL日志未正常打印，可能是配置存在问题。首先，需确认`mybatis.configuration.log-impl`是否正确设置为`STDOUT_LOGGING`或对应的日志实现。其次，检查日志框架（如Log4j、SLF4J）配置文件中，`org.apache.ibatis`或`com.mybatics.flex`的日志级别是否设为`DEBUG`或以上。若使用Spring Boot，确保`application.yml`中包含类似`logging.level.com.mybatics.flex=DEBUG`的配置。 此外，MyBatis-Flex默认依赖MyBatis核心逻辑，若项目中缺少日志依赖（如`mybatis-logger`），也可能导致日志无法输出。最后，确认是否启用了`StatementLogger`或自定义拦截器来增强日志功能。通过逐一排查上述配置，可有效解决SQL日志不打印的问题。

Answer 1

1. 问题概述

在使用MyBatis-Flex时，若发现SQL日志未正常打印，可能是配置存在问题。以下是可能导致该问题的常见原因及解决方案。

• MyBatis核心逻辑的日志实现未正确配置。
• 日志框架（如Log4j、SLF4J）未正确设置日志级别。
• Spring Boot项目中缺少必要的日志依赖或配置。
• 未启用增强日志功能的相关组件，例如StatementLogger或自定义拦截器。

2. 配置检查与调整

首先，需要确认MyBatis-Flex的核心日志实现是否正确设置：

mybatis.configuration.log-impl: STDOUT_LOGGING
    

其次，检查日志框架配置文件中，确保`org.apache.ibatis`或`com.mybatics.flex`的日志级别设为`DEBUG`或以上：

日志框架	配置示例
Log4j	log4j.logger.org.apache.ibatis=DEBUG
SLF4J	<logger name="org.apache.ibatis" level="DEBUG"/>

3. Spring Boot环境下的特殊配置

如果项目基于Spring Boot，需在`application.yml`中添加以下配置：

logging:
  level:
    com.mybatics.flex: DEBUG
    org.apache.ibatis: DEBUG
    

此外，还需确保项目中包含必要的日志依赖，例如：

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-logger</artifactId>
</dependency>
    

4. 增强日志功能的高级选项

如果基础配置无误但日志仍无法输出，可以考虑启用`StatementLogger`或自定义拦截器来增强日志功能：

通过自定义拦截器捕获SQL执行信息：

@Intercepts({@Signature(type = Executor.class, method = "update", args = {MappedStatement.class, Object.class})})
public class SqlLoggerInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 自定义日志逻辑
        return invocation.proceed();
    }
}
    

以下是排查流程图，帮助快速定位问题：

graph TD;
            A[SQL日志未打印] --> B{检查log-impl};
            B --STDOUT_LOGGING--> C{检查日志级别};
            C --DEBUG及以上--> D{检查Spring Boot配置};
            D --正确--> E{检查依赖完整性};
            E --完整--> F{启用增强日志功能};