IDEA配置MyBatis日志插件打印SQL

本文深入解析了IDEA中MyBatis Log插件无法正常打印完整SQL的常见痛点与底层原理，涵盖日志级别配置错位、MyBatis版本与日志实现（如SLF4J）兼容性问题、占位符未替换的真实原因（依赖jdbc包DEBUG级日志）、中文乱码与长SQL截断的IDEA控制台设置优化，以及二级缓存命中、Executor类型异常和自定义执行链路导致插件“失灵”的关键场景；不讲空洞步骤，直击日志未触发的本质——插件只是监听者，只有当SQL真正执行到JDBC日志层且日志开关打开时，它才能精准还原可读的完整SQL，帮你告别“装了却看不到”的无效调试。

MyBatis Log 插件不显示 SQL？先确认日志级别和 MyBatis 版本匹配

插件本身不改日志配置，它只是“劫持” MyBatis 的 org.apache.ibatis.logging.Log 实现并重写输出逻辑。如果控制台没 SQL，大概率是 MyBatis 根本没走日志打印路径——比如你用的是 MyBatis 3.4+，但项目里还残留了旧版 log4j.properties 把 org.apache.ibatis 设成了 ERROR 级别。

• 检查 IDEA 控制台是否真有 MyBatis 启动日志（如 Creating a new SqlSession），没有说明 MyBatis 没加载成功
• 确保 logging.level.org.apache.ibatis=DEBUG（Spring Boot）或对应 logback/log4j 配置中该包为 DEBUG
• MyBatis 3.4.0+ 默认使用 slf4j，插件只对 StdOutImpl 和部分桥接器生效；若你手动指定了 logImpl=SLF4J，插件会失效

插件装了但只打印 ? 占位符，没替换真实参数

这是最常被误认为“插件坏了”的情况。MyBatis Log 插件本身不解析 PreparedStatement 参数，它依赖 MyBatis 自身的 org.apache.ibatis.logging.jdbc.PreparedStatementLogger 输出带参数的 SQL。而这个 logger 只在 MyBatis 日志级别为 DEBUG 且执行语句时才触发。

• 必须保证 org.apache.ibatis.logging.jdbc.BaseJdbcLogger 所在包也设为 DEBUG（例如 Spring Boot 下加 logging.level.org.apache.ibatis.logging.jdbc=DEBUG）
• SQL 中的 #{} 会被替换，但 ${} 是字符串拼接，插件无法还原，看到原样 ${xxx} 属正常
• 批量操作（foreach）或动态 SQL 多层嵌套时，插件可能只捕获最外层语句，内部 if 分支的 SQL 不会单独打印

IntelliJ IDEA 中启用插件后 SQL 还是乱码或截断

根本原因不是插件问题，而是 IDEA 控制台编码或缓冲区限制。MyBatis Log 插件输出的是纯文本，但长 SQL（尤其含中文、JSON 字段）容易被截断或显示为 。

• 在 IDEA → Help → Edit Custom Properties 中添加：console.encoding=UTF-8，重启 IDEA
• 运行配置里勾选 Use soft wraps in console，避免超长 SQL 溢出看不见
• 如果 SQL 超过 2000 字符，IDEA 控制台默认只保留最后 1000 行；可在 Settings → Editor → General → Console 中调高 Override console cycle buffer size（建议设为 20000）

为什么有些 SQL 完全不出现？重点查 Executor 类型和缓存开关

MyBatis Log 插件监听的是 StatementHandler 和 Executor 的日志调用，但以下场景它根本收不到信号：

• 启用了二级缓存（cacheEnabled=true）且命中时，SQL 根本不进 JDBC 层，插件无从捕获
• 用了 REUSE 或 BATCH 类型的 Executor，部分日志被合并或跳过；开发阶段建议强制用 SIMPLE（）
• 手写了 SqlSessionTemplate 或自定义 Interceptor，绕过了标准执行链路，插件监听点失效

插件能工作的前提是：SQL 真的执行到了 JDBC 层，并且 MyBatis 主动调用了日志接口。任何跳过 PreparedStatementLogger 或提前返回的路径，插件都看不到。

好了，本文到此结束，带大家了解了《IDEA配置MyBatis日志插件打印SQL》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！