Spring Batch读取CSV文件如何跳过首行标题行？

嘿，这问题太常见啦！要让你的Spring Batch任务跳过CSV的首行标题，完全不用改动CustomerItemProcessor的代码——咱们直接在读取数据的源头（也就是FlatFileItemReader）上配置就行，这样标题行根本不会流到Processor里。

核心解决方案：给FlatFileItemReader加上跳过首行的配置 #

你的importReader应该是FlatFileItemReader的实例，只要在构建它的时候调用linesToSkip(1)方法，就能告诉Spring Batch跳过第一行。下面是结合你的代码修改后的完整配置示例：

@Configuration
public class ImportJobConfig {

    @Autowired
    private JobBuilderFactory jobBuilderFactory;

    @Autowired
    private StepBuilderFactory stepBuilderFactory;

    // 配置读取CSV的ItemReader，这里加上跳过首行的关键设置
    @Bean
    public FlatFileItemReader<Customer> importReader() {
        return new FlatFileItemReaderBuilder<Customer>()
                .name("customerItemReader")
                .resource(new ClassPathResource("your-customers-data.csv")) // 替换成你的CSV文件路径
                .delimited() // 默认是逗号分隔，要是用分号就加 .delimiter(";")
                .names("id", "name", "email", "phone") // 这里要和CSV标题行的列名一一对应
                .fieldSetMapper(new BeanWrapperFieldSetMapper<Customer>() {{
                    setTargetType(Customer.class); // 映射到你的Customer实体类
                }})
                .linesToSkip(1) // 关键！这一行就是跳过首行标题的配置
                .build();
    }

    // 你的Job和Step配置可以保持原有逻辑不变
    @Bean
    public Job importUserJob(ItemReader<Customer> importReader) {
        return jobBuilderFactory.get("importUserJob")
                .start(importStep(importReader))
                .build();
    }

    @Bean
    public Step importStep(ItemReader<Customer> importReader) {
        return stepBuilderFactory.get("importStep")
                .<Customer, Customer>chunk(10)
                .reader(importReader)
                .processor(customerItemProcessor()) // 现在这个Processor只会收到有效数据啦
                .writer(customerItemWriter())
                .build();
    }

    // 你的Processor和Writer配置...
    @Bean
    public CustomerItemProcessor customerItemProcessor() {
        return new CustomerItemProcessor();
    }

    @Bean
    public ItemWriter<Customer> customerItemWriter() {
        // 这里写你的数据写入逻辑
        return items -> {
            for (Customer customer : items) {
                // 比如写入数据库或者其他操作
            }
        };
    }
}

为什么这么做更合理？ #

Spring Batch的组件是职责分离的：ItemReader负责读取数据，ItemProcessor负责处理业务逻辑。在Reader阶段就跳过标题行，既符合单一职责原则，也避免了在Processor里写冗余的判断逻辑（比如判断当前行是不是标题再跳过），代码会更干净易维护。

额外注意点 #

• 一定要保证names()方法里的列名和CSV标题行的名称完全对应，这样BeanWrapperFieldSetMapper才能正确把CSV列映射到Customer实体的属性上。
• 如果你的CSV用了非逗号的分隔符（比如分号;、制表符\t），记得在delimited()后面加上.delimiter("你的分隔符")来指定。

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