Spring Boot Batch DB转CSV：无法按Id排序及显示列标题求助

一、修复CSV数据排序混乱问题 #

你已在RepositoryItemReader中配置了按id升序的规则，但step使用了SimpleAsyncTaskExecutor异步任务执行器，多个chunk并行处理时，写入CSV的顺序会被打乱（先处理完成的chunk会优先写入，不遵循查询的原始顺序）。

修改方案： #

如果不需要并行导出，直接移除step中的异步任务执行器，改为单线程执行：

@Bean
public Step step1() {
    return stepBuilderFactory.get("csv-step").<User, User>chunk(10)
            .reader(reader())
            .processor(processor())
            .writer(writer())
            .listener(stepExecutionListener())
            // 移除异步任务执行器配置
            .build();
}

单线程模式下，RepositoryItemReader的排序规则会生效，数据会按id升序逐chunk处理并写入CSV。

若需保留并行且保证顺序，可使用Spring Batch 4.3+提供的OrderedFlatFileItemWriter，但该方式配置复杂度较高，对于需严格排序的导出场景，单线程执行是更简单可靠的选择。

二、添加CSV列标题 #

FlatFileItemWriter默认不会生成列标题，需通过headerCallback配置实现：

修改writer配置： #

@Bean
public FlatFileItemWriter<User> writer() {

    FlatFileItemWriter<User> writer = new FlatFileItemWriter<>();

    writer.setResource(outputResource);
    writer.setAppendAllowed(true);

    // 配置列标题写入回调
    writer.setHeaderCallback(headerWriter -> headerWriter.write("id,age,birthday,country,email,firstName,gender,lastName,personId"));

    writer.setLineAggregator(new DelimitedLineAggregator<User>() {
        {
            setDelimiter(",");
            setFieldExtractor(new BeanWrapperFieldExtractor<User>() {
                {
                    setNames(new String[]{"id", "age", "birthday", "country", "email", "firstName", "gender", "lastName", "personId"});
                }
            });
        }
    });

    return writer;
}

修改后导出的CSV文件首行将显示与数据字段顺序对应的列标题。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu