Spring Batch SQL查询日志问题：无法记录JdbcCursorItemReader普通语句

我碰到过类似的问题，JdbcCursorItemReader的SQL日志确实容易让人困惑，毕竟它的底层执行逻辑和Spring JDBC的常规操作略有不同。咱们一步步来排查解决：

1. 先明确：JdbcCursorItemReader默认用PreparedStatement #

首先要搞清楚，JdbcCursorItemReader默认就是使用PreparedStatement执行SQL，哪怕你的SQL没有占位符。所以你说的“普通语句”如果是指填充了参数的完整SQL（而非带?的预编译语句），那光开java.sql的日志是不够的——JDBC规范里的java.sql日志只会打印预编译模板和参数列表，不会自动拼接出完整SQL。

2. 开启JDBC驱动的专属日志 #

不同数据库的JDBC驱动有自己的日志开关，这才是打印完整执行SQL的关键：

• MySQL 8.x+：添加配置 logging.level.com.mysql.cj.jdbc=DEBUG
• MySQL 5.x：用 logging.level.com.mysql.jdbc=DEBUG
• PostgreSQL：添加 logging.level.org.postgresql=DEBUG
• Oracle：配置 logging.level.oracle.jdbc=DEBUG

这些驱动日志会直接输出最终执行的、填充了所有参数的完整SQL语句。

3. 补充Spring Batch专属包的日志级别 #

除了你已经配置的org.springframework.jdbc，还要打开JdbcCursorItemReader所在包的DEBUG日志，这样能看到它初始化、获取游标、执行查询的完整流程：

logging.level.org.springframework.batch.item.database=DEBUG

4. 确认你的日志配置没有被覆盖 #

如果你用的是Logback/Log4j2这类日志框架，要检查配置文件（比如logback-spring.xml）里有没有其他规则覆盖了这些DEBUG级别。比如有些全局配置可能把java.sql的级别设成了INFO，那你的application.properties配置就会失效。

举个完整的application.properties配置示例（以MySQL 8为例）：

# Spring JDBC基础日志
logging.level.org.springframework.jdbc=DEBUG
# Spring Batch数据库相关组件日志
logging.level.org.springframework.batch.item.database=DEBUG
# JDBC规范日志
logging.level.java.sql=DEBUG
logging.level.java.sql.Connection=DEBUG
logging.level.java.sql.Statement=DEBUG
logging.level.java.sql.PreparedStatement=DEBUG
# MySQL驱动日志（打印完整SQL）
logging.level.com.mysql.cj.jdbc=DEBUG

最后再验证一下 #

启动你的Spring Batch任务后，查看日志：

• 你会看到org.springframework.batch.item.database.JdbcCursorItemReader的日志，显示它初始化SQL、创建PreparedStatement的过程
• 驱动日志会输出类似Executing SQL statement: SELECT * FROM your_table WHERE id = 123这样的完整语句

内容的提问来源于stack exchange，提问作者Angelo Tricarico