使用@EnableScheduling与@Scheduled时启动任务重复执行问题

问题分析 #

核心原因是Spring Batch默认会在应用启动时自动执行所有已定义的Job，这就是启动阶段main线程执行exportStep的根源——此时定时任务还未触发，自然没有传入有效的JobParameters。需要禁用这个默认行为，让Job仅通过定时任务线程触发执行。

解决方案 #

1. 禁用Spring Batch自动执行Job #

有两种方式可以关闭自动执行逻辑：

方式一：注解配置

在BatchConfig的@EnableBatchProcessing注解中添加autoStartup = false：

@Configuration
@EnableBatchProcessing(autoStartup = false)
public class BatchConfig {
    // 原有代码保持不变
}

方式二：配置文件

在application.properties或application.yml中加入全局配置：

spring.batch.job.enabled=false

2. 调整ExcelWriter作用域（建议优化） #

你的ExcelWriter默认是单例Bean，但定时任务每次需要生成独立的Excel文件。将其改为原型作用域，确保每次Job执行都使用全新实例：

@Component
@Scope("prototype")
public class ExcelWriter implements ItemWriter<Transaction> {
    // 原有代码保持不变
}

3. 优化定时任务的Job执行逻辑 #

移除JobParametersHolder，直接将构造好的JobParameters传入jobLauncher.run()，同时添加唯一参数（如fileId）确保每次Job实例唯一，避免Spring Batch因参数重复跳过执行：

@Component
@EnableScheduling
public class BatchScheduler {
    private final JobLauncher jobLauncher;
    private final Job transactionExportJob;
    private final ApplicationContext applicationContext;

    public BatchScheduler(JobLauncher jobLauncher, Job transactionExportJob, ApplicationContext applicationContext) {
        this.jobLauncher = jobLauncher;
        this.transactionExportJob = transactionExportJob;
        this.applicationContext = applicationContext;
    }

    @Scheduled(fixedRate = 60000, initialDelay = 60000, zone = "Asia/Shanghai")
    public void runBatchJob() {
        try {
            // 获取原型作用域的ExcelWriter实例
            ExcelWriter excelWriter = applicationContext.getBean(ExcelWriter.class);
            LocalDateTime startTime = LocalDateTime.now().minusDays(1).withHour(22);
            JobParameters jobParameters = new JobParametersBuilder()
                    .addDate("startTime", Date.from(startTime.atZone(ZoneId.of("Asia/Shanghai")).toInstant()))
                    .addDate("endTime", Date.from(LocalDateTime.now().withHour(22).atZone(ZoneId.of("Asia/Shanghai")).toInstant()))
                    .addString("fileId", UUID.randomUUID().toString()) // 保证Job实例唯一性
                    .toJobParameters();

            System.out.println("jobParameters: " + jobParameters);
            System.out.println("Batch Job started");

            JobExecution execution = jobLauncher.run(transactionExportJob, jobParameters);
            System.out.println("Batch job completed with status: " + execution.getStatus());
            excelWriter.closeWorkbook();
        } catch (Exception e) {
            System.out.println("Batch job execution failed: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

关键说明 #

• 禁用自动启动后，Spring Batch仅会通过jobLauncher.run()触发Job执行，彻底避免启动阶段main线程的无效执行。
• 原型作用域的ExcelWriter确保每次定时任务生成独立文件，不会出现数据覆盖问题。
• 唯一JobParameters参数是Spring Batch的强制要求：只有参数不同，才会被识别为新的Job实例执行，否则会因重复实例判定跳过执行。

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