本文介绍在使用 mvn spring-boot:run 启动 spring batch 应用时，如何正确传递 jobparameters（如 input.file=/data/in.csv），并通过 run.arguments 机制实现参数注入与自动解析。
本文介绍在使用 mvn spring-boot:run 启动 spring batch 应用时，如何正确传递 jobparameters（如 input.file=/data/in.csv），并通过 run.arguments 机制实现参数注入与自动解析。
在 Spring Boot + Spring Batch 项目中，仅通过 -Dspring.batch.job.names=MyJobNameHere 只能指定要启动的作业名称，但无法直接传入运行时所需的 JobParameters（例如文件路径、日期范围、标志位等）。这些参数对作业的幂等性、重跑控制和数据隔离至关重要。
幸运的是，Spring Boot 的 spring-boot-maven-plugin 提供了标准机制：使用 -Drun.arguments 传入逗号分隔的键值对，这些参数会被自动解析为 ApplicationRunner 或 CommandLineRunner 的输入，并被 Spring Batch 的 JobLauncher 自动转换为 JobParameters（前提是启用了 JobParametersBuilder 的默认解析逻辑）。
✅ 正确用法如下：
mvn spring-boot:run \ -Dspring.batch.job.names=importUserJob \ -Drun.arguments="input.file=/tmp/users.csv,job.date=2024-06-15,skip.validation=true" \ -f pom.xml
上述命令将生成包含以下参数的 JobParameters：
new JobParametersBuilder()
.addString("input.file", "/tmp/users.csv")
.addString("job.date", "2024-06-15")
.addBoolean("skip.validation", true)
.toJobParameters();
⚠️ 注意事项：
- 参数名必须为合法的 Java 标识符（避免点号 . 或特殊字符），若需语义化命名（如 input.file），Spring Boot 默认支持（底层使用 DefaultApplicationArguments 解析，. 会被保留）；
- 值中若含空格或逗号，需用单引号包裹：-Drun.arguments="name='John Doe',tags='A,B,C'"；
- 若作业未配置为自动启动（即 spring.batch.job.enabled=false），需确保代码中显式调用 JobLauncher.run(job, jobParameters)；
- Spring Batch 5+ 与 Spring Boot 3.x 中该机制保持兼容，无需额外配置；但请确认 spring-boot-starter-batch 已引入且 @EnableBatchProcessing（或自动配置）已生效。
? 小技巧：可在 @JobScope Bean 中通过 @Value("#{jobParameters['input.file']}") 直接注入参数值，实现动态资源绑定。
总之，-Drun.arguments 是 Maven 环境下最轻量、最标准的 JobParameters 注入方式——无需修改代码、不依赖外部配置中心，即可实现灵活、可复现的批量作业调试与部署。
