第二次调用API执行Spring Batch作业时出现ItemStreamException：读取器初始化失败

我之前也碰到过一模一样的问题，这个org.springframework.batch.item.ItemStreamException（读取器初始化失败）通常是因为Excel读取器的资源没正确释放，或者状态被重复复用导致的。结合你的技术栈，给你几个经过验证的解决方案：

可能的根因 #

• 资源泄漏：第一次作业跑完后，Excel文件的输入流没被彻底关闭，第二次尝试打开时文件被占用。
• Reader状态污染：默认情况下Spring Bean是单例的，如果你的Excel Reader是单例，第一次运行后的游标位置、文件句柄等状态会保留，第二次直接复用就会出错。
• ItemStream接口未正确实现重置：Spring Batch Excel的PoiItemReader实现了ItemStream，但如果作业重复运行时没有触发正确的状态重置，也会出问题。

具体解决方案 #

1. 把Reader设置为Step作用域（最推荐） #

让Reader每次执行步骤时都生成新实例，从根本上避免状态污染。只需要给Reader的Bean加上@StepScope注解：

@Bean
@StepScope
public ItemReader<YourDataDto> excelItemReader() {
    PoiItemReader<YourDataDto> reader = new PoiItemReader<>();
    reader.setResource(new FileSystemResource("path/to/your/file.xlsx"));
    // 配置行映射器、跳过表头行数等
    reader.setRowMapper(new BeanWrapperRowMapper<>(YourDataDto.class));
    reader.setLinesToSkip(1); // 如果有表头的话
    return reader;
}

注：Spring Boot默认已经支持Step作用域，不需要额外配置，这个方法能解决90%以上的同类问题。

2. 手动关闭Reader资源 #

如果因为某些原因不能改作用域，可以自定义一个ItemStreamListener，在作业结束后强制关闭Reader的资源：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.batch.core.ItemStreamListener;
import org.springframework.batch.item.excel.poi.PoiItemReader;

public class ExcelReaderCleanupListener implements ItemStreamListener<YourDataDto> {
    private static final Logger log = LoggerFactory.getLogger(ExcelReaderCleanupListener.class);
    private final PoiItemReader<YourDataDto> reader;

    public ExcelReaderCleanupListener(PoiItemReader<YourDataDto> reader) {
        this.reader = reader;
    }

    @Override
    public void close() {
        try {
            reader.close();
            log.info("Excel reader resource closed successfully");
        } catch (Exception e) {
            log.error("Failed to close Excel reader", e);
        }
    }

    // 其他接口方法可以留空
    @Override public void open(org.springframework.batch.item.ExecutionContext executionContext) {}
    @Override public void update(org.springframework.batch.item.ExecutionContext executionContext) {}
    @Override public void beforeRead() {}
    @Override public void afterRead(YourDataDto item) {}
    @Override public void onReadError(Exception ex) {}
}

然后在Step配置里注册这个监听器：

@Bean
public Step excelProcessingStep() {
    return stepBuilderFactory.get("excelProcessingStep")
            .<YourDataDto, YourDataDto>chunk(10)
            .reader(excelItemReader())
            .writer(yourItemWriter())
            .listener(new ExcelReaderCleanupListener(excelItemReader()))
            .build();
}

3. 每次启动作业创建新实例 #

通过添加唯一的Job参数，让每次作业都生成新的实例，避免复用之前的Reader状态：

JobParameters jobParams = new JobParametersBuilder()
        .addString("filePath", "path/to/your/file.xlsx")
        .addLong("runTimestamp", System.currentTimeMillis()) // 用时间戳保证唯一性
        .toJobParameters();

jobLauncher.run(yourExcelJob(), jobParams);

这样每次调用作业都是全新的执行上下文，不会受上次运行的影响。

4. 检查依赖版本兼容性 #

确保spring-batch-excel的版本和你的Spring Boot、Spring Batch版本匹配。比如旧版本可能存在资源泄漏的bug，建议升级到最新稳定版：

<!-- Maven依赖示例 -->
<dependency>
    <groupId>org.springframework.batch.extensions</groupId>
    <artifactId>spring-batch-excel</artifactId>
    <version>1.1.0.RELEASE</version> <!-- 可根据Spring Boot版本调整，比如2.x用1.x，3.x用2.x -->
</dependency>

总结 #

优先尝试Step作用域的方案，这是最简洁且从根源解决问题的方式。如果还是不行，再结合资源关闭监听器和唯一Job参数的方法排查。

内容的提问来源于stack exchange，提问作者Explain Down Vote