在开发基于数据库的应用程序时，了解程序实际执行的SQL语句是调试和优化的重要环节。通过控制台输出SQL日志，开发者可以直观地分析数据库交互过程，定位潜在的性能瓶颈或逻辑错误。本文将系统梳理MyBatis框架下实现SQL打印的配置技巧，并提供调试场景中的实用建议。
一、原生MyBatis配置实现SQL打印
核心原理：MyBatis通过内置的日志工厂（LogFactory）将SQL执行过程输出到控制台，支持多种日志实现（如SLF4J、Log4j2等）。
1. XML配置文件激活标准输出
在`mybatis-config.xml`中添加`
xml
此配置会直接在控制台输出完整的SQL语句和参数，格式形如：
==> Preparing: SELECT FROM user WHERE name = ?
==> Parameters: John(String)
（参考实现：）
2. 动态切换日志实现
若项目已集成Log4j2等日志框架，可通过调整`logImpl`值（如`LOG4J2`）将SQL输出到文件或其他介质，同时保持与其他日志的统一管理。
二、Spring Boot集成环境下的快速配置
在Spring Boot项目中，通常通过YAML或Properties文件简化配置，无需编写XML。
1. YAML文件直接配置
在`application.yml`中指定MyBatis的日志实现类：
yaml
mybatis:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
此方式等价于XML配置，但更符合Spring Boot的简洁风格。
2. 包路径日志级别控制
通过调整特定Mapper接口所在包的日志级别为`DEBUG`，可触发SQL打印：
yaml
logging:
level:
com.example.mapper: debug
此方法的优势在于灵活控制不同模块的日志输出粒度，例如仅监控核心业务模块的SQL。
三、结合日志框架的进阶配置
对于需要持久化SQL日志或精细化管理的场景，建议集成Log4j2、Logback等专业日志工具。
1. Log4j2实现日志分级存储
配置`log4j2.xml`文件，将MyBatis的DEBUG日志单独输出到文件：
xml
此配置实现按天分割日志文件，避免单个文件过大。
2. Logback的多环境适配
在`logback-spring.xml`中定义开发与生产环境的不同策略：
xml
开发环境输出详细SQL，生产环境则关闭以避免性能损耗。
四、MyBatis-Plus的扩展功能
MyBatis-Plus在原生功能基础上提供增强型调试支持。
1. 内置SQL打印配置
在`application.yml`中激活MP的SQL日志：
yaml
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
此配置与原MyBatis语法兼容，但额外支持MP特有的条件构造器SQL输出。
2. P6Spy组件的SQL分析
通过引入`p6spy`依赖，可记录SQL执行耗时并检测慢查询：
xml
配置文件中定义耗时阈值（如2秒）：
yaml
decorator:
datasource:
p6spy:
outagedetectioninterval: 2
执行超时的SQL会被标记，便于针对性优化。
五、调试场景中的实用技巧
1. 动态参数占位符解析
当SQL语句包含`${}`动态参数时，需结合`{}`预编译占位符使用，避免日志中显示未替换的变量名。
2. IDEA插件辅助分析
安装`MyBatis Log Plugin`或`SQL Params Setter`插件，可自动将日志中的预编译语句转换为实际SQL，提升调试效率。
3. 敏感信息脱敏处理
在日志配置中使用正则表达式过滤密码等敏感字段：
xml
结论与建议
SQL日志输出是开发阶段的利器，但需注意：
通过合理配置，开发者既能获得充分的调试信息，又能保障系统运行的稳定与安全。实际项目中可根据团队技术栈选择最适合的方案，例如小型项目可采用Spring Boot原生配置，中大型系统则推荐结合Log4j2或商业监控工具实现全方位SQL审计。
