Spring Batch实战:CSV文件处理中ItemReader与ItemWriter的五大配置陷阱与解决方案
当你第一次在Spring Batch中成功运行CSV文件读写示例时,那种成就感可能让你误以为已经掌握了这项技术。但现实往往会在实际项目中给你当头一棒——文件编码乱码、字段映射失败、性能低下等问题接踵而至。本文将揭示那些官方文档没有明确指出的配置陷阱,帮助开发者从"能运行"进阶到"懂得为何这样配置且能稳定运行"。
1. 资源路径配置:ClassPathResource与FileSystemResource的隐藏差异
许多开发者在使用FlatFileItemReader和FlatFileItemWriter时,往往对Resource接口的不同实现类选择不当,导致文件找不到或权限问题。以下是两种常见Resource实现的对比:
| 实现类 | 适用场景 | 路径基准点 | 生产环境风险点 |
|---|---|---|---|
| ClassPathResource | 打包在JAR内的资源文件 | 项目classpath根目录 | JAR包内文件不可修改 |
| FileSystemResource | 外部文件系统或绝对路径文件 | 文件系统根目录 | 路径硬编码导致环境不兼容 |
典型错误示例:
java复制// 反例:生产环境可能找不到文件
reader.setResource(new ClassPathResource("data/input.csv"));
// 反例:Windows绝对路径导致Linux部署失败
writer.setResource(new FileSystemResource("C:/output/output.csv"));
最佳实践方案:
- 对于输入文件,使用Spring的ResourceLoader动态加载:
java复制@Autowired
private ResourceLoader resourceLoader;
public ItemReader<Item> reader(@Value("${input.file}") String filePath) {
FlatFileItemReader<Item> reader = new FlatFileItemReader<>();
reader.setResource(resourceLoader.getResource(filePath));
// 其他配置...
}
- 对于输出文件,采用环境感知的路径策略:
properties复制# application.properties
output.directory=/var/batch/output
java复制@Value("${output.directory}")
private String outputDir;
pu
