Java项目整合MyBatis与Log4j查看SQL日志

本文深入解析了在Java项目中整合MyBatis与Log4j以完整查看SQL日志（含真实参数值）的关键配置与常见陷阱，指出仅设置日志级别为DEBUG远远不够——必须精准启用`BaseJdbcLogger=DEBUG`、正确配置JDBC驱动参数（如MySQL的`profileSQL=true`）、规避日志桥接冲突（如`log4j-over-slf4j`）、确保Spring Boot中`mybatis.configuration.log-impl`生效，并排查依赖冲突、资源过滤、SqlSessionFactory初始化缺失等高频“静默失效”问题，帮你彻底告别“SQL有形无实、问号满天飞”的调试困境。

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项目整合MyBatis与Log4j查看SQL日志》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！