开启 mybatis sql 日志需同时配置 basejdbclogger=debug 和 jdbc 驱动参数追踪(如 mysql 加 profilesql=true),否则仅显示问号而无实际参数值。

MyBatis 开启 SQL 日志为什么没看到参数值?
默认开启 log4j 只能打印语句骨架(比如 SELECT * FROM user WHERE id = ?),看不到实际传入的 id 值。这是因为 MyBatis 的日志输出分两层:SQL 模板归 org.apache.ibatis.logging.jdbc.BaseJdbcLogger 管,而参数绑定是另一套逻辑,必须显式启用 PreparedStatement 的调试日志。
- 关键配置项是
log4j.logger.org.apache.ibatis.logging.jdbc.BaseJdbcLogger=DEBUG,不是INFO或WARN - MyBatis 3.4+ 默认使用 SLF4J 绑定,若项目里混用
log4j(非log4j2),需确保log4j-over-slf4j未引入,否则日志被桥接吞掉 - Spring Boot 项目容易漏掉
mybatis.configuration.log-impl=org.apache.ibatis.logging.log4j.Log4jImpl,否则 MyBatis 自己的日志委托机制不生效
Log4j.properties 中哪些 logger 必须配全?
只配 org.apache.ibatis 不够,参数和执行细节分散在多个类里,缺一不可:
-
log4j.logger.org.apache.ibatis=DEBUG—— 总开关,但粒度太粗 -
log4j.logger.org.apache.ibatis.logging.jdbc.BaseJdbcLogger=DEBUG—— 打印带问号的 SQL + 实际参数值(如Parameters: 123(Long)) -
log4j.logger.org.apache.ibatis.executor.statement=DEBUG—— 查看 Statement 创建、参数设置过程(含 JDBC 类型映射) -
log4j.logger.org.apache.ibatis.datasource=INFO—— 通常 INFO 足够,DEBUG 会刷屏连接池状态
注意:BaseJdbcLogger 是核心,漏掉它就等于白配。
Spring Boot 项目里 Log4j 配置不生效的三个高频原因
不是配置写错了,而是环境或依赖链卡住了:
- 用了
spring-boot-starter-web却没排除默认的spring-boot-starter-logging(Logback),导致 Log4j 被自动禁用 -
log4j.properties放在src/main/resources下,但 Maven 打包时被其他插件过滤(比如resources配置了includes却没包含*.properties) - MyBatis 的
SqlSessionFactoryBean手动 new 出来且没调用setConfiguration(),导致自定义LogImpl未注入
验证方式:启动时搜日志里有没有 Parsing configuration file: mybatis-config.xml,没有说明 MyBatis 根本没加载你的配置。
看到 SQL 但参数全是问号?检查 JDBC 驱动和连接 URL
即使日志级别全开,某些 JDBC 驱动(尤其旧版 MySQL Connector/J)默认关闭参数追踪。现象是日志里只有 Parameters: ?,没有具体值。
- MySQL 驱动需在连接 URL 加
&profileSQL=true&useInformationSchema=true(5.x)或&logger=com.mysql.cj.log.StandardLogger&profileSQL=true(8.x) - HikariCP 连接池要加
data-source-properties: profileSQL:true,否则驱动层日志被池截断 - PostgreSQL 需设
loggerLevel=TRACE并确保驱动版本 ≥ 42.2.0,老版本不支持参数展开
真正麻烦的是混合场景:MyBatis 日志开了,JDBC 驱动没开,结果你盯着 BaseJdbcLogger 发呆,其实问题在 URL 末尾少了个 &。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











