如何配置Spring Batch使Reader、Processor、Writer按页逐次执行？

Spring Batch完全可以自动实现你需要的逐页（逐chunk）执行逻辑，这正是它的chunk处理模型的核心设计。以下是具体分析和解决方案：

核心原理：Chunk 模式的原生行为 #

当你在Step中配置.chunk(1000)时，Spring Batch的默认执行流程就是：

• Reader 读取1000条数据（对应一页）
• Processor 批量转换这1000条数据
• Writer 批量写入转换后的数据
• 完成当前chunk后，重复上述流程直到Reader返回null（所有数据读取完成）

这完全匹配你期望的"读一页→处理→写入→再读下一页"的需求。

为什么你会觉得是一次性执行？ #

你当前配置中加入了.taskExecutor(taskExecutor)和.throttleLimit(20)，这会让Spring Batch启用多线程并行处理多个chunk。也就是说，系统会同时读取多页数据、并行执行处理和写入操作，所以看起来像是一次性完成了所有任务。

如果需要严格按顺序逐页执行，只需移除taskExecutor相关配置即可，回到单线程的chunk处理模式。

关键配置检查：RepositoryItemReader 的分页设置 #

确保你的RepositoryItemReader正确配置了分页参数，否则会影响逐页读取的效果：

@Bean
public RepositoryItemReader<PurchaseEntity> purchaseItemReader(PurchaseRepository repository) {
    RepositoryItemReader<PurchaseEntity> reader = new RepositoryItemReader<>();
    reader.setRepository(repository);
    reader.setMethodName("findAll"); // 需调用支持Pageable的Repository方法
    reader.setPageSize(1000); // 必须和Step中配置的chunk size保持一致
    // 必须指定排序字段，避免数据库分页结果不稳定导致数据重复/遗漏
    reader.setSort(Collections.singletonMap("id", Sort.Direction.ASC));
    return reader;
}

注意：排序字段是必填项，否则数据库的分页查询无法保证数据的一致性，可能出现重复读取或遗漏数据的问题。

验证逐页执行的方法 #

可以在Reader、Processor、Writer的实现中添加日志输出，比如：

• Reader读取完成后打印：读取第[X]页，共1000条数据
• Processor处理完成后打印：完成第[X]页数据转换
• Writer写入完成后打印：完成第[X]页数据写入

通过日志就能清晰看到流程是否按预期逐页执行：单线程模式下日志会按顺序输出每一页的处理步骤；多线程模式下会同时出现多个chunk的日志。

内容的提问来源于stack exchange，提问作者Jérémie