Spring Batch中RepositoryItemReader调用无参原生查询失败问题

核心问题分析 #

RepositoryItemReader是分页批量读取组件，必须满足两个前提才能正常工作：

1. 仓库方法必须支持Pageable参数，且返回Page<Employee>（配合countQuery实现分页计数）
2. 必须指定稳定的排序规则（避免分页时数据重复/遗漏）

正确代码实现 #

1. 调整JPA Repository方法 #

将无参原生查询改为支持分页的版本，返回Page类型并指定countQuery：

@Repository
public interface EmployeeRepository extends JpaRepository<Employee, Integer> {

    @Query(value = "SELECT id, name, town, datecheck FROM public.employee",
           countQuery = "SELECT COUNT(*) FROM public.employee",
           nativeQuery = true)
    Page<Employee> findAllEmployees(Pageable pageable);
}

2. 正确配置RepositoryItemReader #

使用RepositoryItemReaderBuilder构建Reader，指定排序规则、分页大小：

@Bean
public RepositoryItemReader<Employee> employeeRepositoryItemReader(EmployeeRepository employeeRepository) {
    return new RepositoryItemReaderBuilder<Employee>()
            .repository(employeeRepository)
            .methodName("findAllEmployees")
            .sorts(Collections.singletonMap("id", Sort.Direction.ASC)) // 用主键排序保证稳定性
            .pageSize(10) // 按需设置每页读取条数
            .build();
}

为什么之前的尝试失败？ #

• 问题1：未指定sort，且仓库方法不支持Pageable。RepositoryItemReader依赖分页读取，必须通过sort保证分页的一致性，否则会抛出sort should not be null错误。
• 问题2：仓库方法返回List<Employee>而非Page<Employee>，且未配置countQuery，Spring Data无法正确计算总页数，导致分页逻辑失效。
• 问题3：核心需求是无参查询，带参数的场景本质和无参一致，但需保证参数传递正确（你的配置中参数是正确的，但同样需要满足分页和sort的要求）。

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