mybatis log 插件不显示sql的主因是日志级别未设为debug或mybatis未实际执行sql；需确认logging.level.org.apache.ibatis和org.apache.ibatis.logging.jdbc均为debug，且排除二级缓存命中、executor类型异常及日志框架冲突。
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（<setting name="defaultExecutorType" value="SIMPLE"></setting>） - 手写了
SqlSessionTemplate或自定义Interceptor，绕过了标准执行链路，插件监听点失效
插件能工作的前提是：SQL 真的执行到了 JDBC 层，并且 MyBatis 主动调用了日志接口。任何跳过 PreparedStatementLogger 或提前返回的路径，插件都看不到。
