Spring Batch报错Path must not be null：ItemReader传参问题求助

错误原因 #

核心问题是注入的filePath参数为null，导致创建FileSystemResource时触发IllegalArgumentException: Path must not be null异常，具体触发场景包括：

• 启动批处理Job时，没有传入filePath这个必填的Job参数
• 传入的参数名和代码中jobParameters['filePath']的键名不匹配（大小写敏感）
• Spring Boot启动时，参数没有正确绑定到Job参数上下文

解决办法 #

1. 启动时传入正确的filePath参数 #

• 命令行启动：使用Spring Batch的CommandLineJobRunner时，在命令末尾追加参数：

  java -jar your-app.jar --filePath=/absolute/path/to/your/datafile.csv
  

• 代码内启动Job：通过JobParametersBuilder显式传入参数：

  JobParameters jobParams = new JobParametersBuilder()
      .addString("filePath", "/your/file/path.csv")
      // 可选：添加唯一标识参数避免重复执行
      .addLong("runId", System.currentTimeMillis())
      .toJobParameters();
  jobLauncher.run(importUserJob, jobParams);
  

2. 校验参数名一致性 #

确保启动时传入的参数名和代码中@Value("#{jobParameters['filePath']}")的filePath完全一致，注意参数名是大小写敏感的，比如不能写成FilePath或file-path。

3. 添加参数非空校验（可选但推荐） #

在reader方法开头添加断言，提前暴露参数缺失问题，避免进入后续逻辑抛出模糊异常：

@Bean
@StepScope
public BeanIOFlatFileItemReader<Contact> reader(@Value("#{jobParameters['filePath']}") String filePath) {               
    // 提前校验参数非空
    org.springframework.util.Assert.notNull(filePath, "Job参数'filePath'不能为空");
    
    BeanIOFlatFileItemReader<Contact> reader = new BeanIOFlatFileItemReader<>();        
    reader.setUseSpringExceptions(true);
    reader.setResource(new FileSystemResource(filePath));           
    reader.setStreamName(inputContactStreamName);
    reader.setStreamMapping(new ClassPathResource(beanIoConfigurationXmlPath));
    reader.setStreamFactory(StreamFactory.newInstance());
    
    return reader;      
}

4. 可选：设置默认参数值 #

如果业务允许filePath有默认值，可以通过SpEL表达式指定默认值，防止参数缺失时异常：

@Value("#{jobParameters['filePath'] ?: '/default/path/to/file.csv'}") String filePath

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