使用Spring Batch JDBC Item Reader读取Oracle库时遇ORA-01008未绑定变量问题

错误信息翻译 #

org.springframework.jdbc.UncategorizedSQLException: StatementCallback; 未分类SQL异常，执行的SQL为 [ SELECT * From ( SELECT * FROM table_name WHERE processtime is NULL AND RECORN_NUM BETWEEN :startPos AND :endPos order by RECORD_NUM <=100]; SQL状态码 [72000]; 错误代码 [10008]: ORA-10008: 并非所有变量都已绑定; 嵌套异常为...

问题根源 #

1. 错误的分页逻辑写法：手动在WhereClause中添加RECOR_NUM BETWEEN :startPos AND :endPos的分页范围条件，但SqlPagingQueryProviderFactoryBean会自动生成分页所需SQL逻辑，手动添加的startPos和endPos变量未被框架绑定，触发变量未绑定错误。
2. 静态方法调用错误：代码直接调用SqlPagingQueryProviderFactoryBean.setXXX静态方法，而非实例testVar的set方法，导致配置未生效到目标实例。
3. SQL语法错误：生成的SQL存在括号不匹配、order by RECORD_NUM <=100语法错误，以及代码中WhereClause结尾多余的) return ..片段，加剧执行异常。
4. 字段名拼写错误：代码中RECOR_NUM应为RECORD_NUM，拼写错误会导致SQL执行异常。

修复步骤及正确代码示例 #

核心原则 #

不要手动拼接分页范围条件，依赖SqlPagingQueryProviderFactoryBean根据数据库类型自动生成分页SQL，仅保留业务过滤条件。

// 正确创建并配置SqlPagingQueryProviderFactoryBean实例
final SqlPagingQueryProviderFactoryBean queryProviderFactory = new SqlPagingQueryProviderFactoryBean();
queryProviderFactory.setDataSource(dataSource);
queryProviderFactory.setSelectClause("select *");
queryProviderFactory.setFromClause("from " + tableName);
// 仅保留业务过滤条件，移除手动分页范围
queryProviderFactory.setWhereClause("where processtime is NULL");

// 设置分页排序键，框架基于此生成连续分页逻辑
Map<String, Order> sortKeys = new HashMap<>();
sortKeys.put("RECORD_NUM", Order.ASCENDING); // 注意字段名拼写正确
queryProviderFactory.setSortKeys(sortKeys);

// 初始化QueryProvider并配置到JdbcPagingItemReader
SqlPagingQueryProvider queryProvider = queryProviderFactory.getObject();
JdbcPagingItemReader<YourEntity> reader = new JdbcPagingItemReader<>();
reader.setDataSource(dataSource);
reader.setQueryProvider(queryProvider);
reader.setPageSize(100); // 设置每页读取数量，框架自动处理分页范围
reader.setRowMapper(new BeanPropertyRowMapper<>(YourEntity.class));

额外注意事项 #

• 确保排序键RECORD_NUM是数据库表中存在的有效字段且支持排序，这是保证分页连续性、避免数据重复/遗漏的关键。
• 必须对SqlPagingQueryProviderFactoryBean实例进行配置，禁止静态调用类的set方法。
• 检查所有SQL片段的语法正确性，避免多余括号、关键字错误等问题。

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