Spring-Batch作业执行后无法终止，陷入循环调度问题求助

这问题我之前帮同事排查过类似的，核心问题大概率出在调度器的触发逻辑或者Spring Batch作业的执行状态管理上，咱们一步步来理清楚：

如果你用的是Spring自带的@Scheduled注解，一定要分清fixedRate和fixedDelay的区别：

• fixedRate = 5000：不管上一次作业是否执行完成，每隔5秒就触发一次，这必然会导致作业重叠执行，看起来像“陷入循环”
• fixedDelay = 5000：等上一次作业完全执行结束后，再延迟5秒触发下一次，这正是你想要的逻辑

举个正确的代码示例：

// 错误写法：会导致重叠执行
// @Scheduled(fixedRate = 5000)

// 正确写法：等待上一次完成后再延迟5秒
@Scheduled(fixedDelay = 5000)
public void launchBatchJob() throws Exception {
    jobLauncher.run(yourBatchJob, buildUniqueJobParams());
}

如果作业本身逻辑有问题，一直处于RUNNING状态，调度器的fixedDelay也无法正常生效。你可以通过这两点排查：

• 查看作业执行日志，确认JobExecution的最终状态是COMPLETED（而非RUNNING/FAILED）。可以加个监听打印状态：

  @Bean
  public JobExecutionListener jobStatusListener() {
      return new JobExecutionListenerSupport() {
          @Override
          public void afterJob(JobExecution jobExecution) {
              System.out.println("作业执行结束，状态：" + jobExecution.getStatus());
          }
      };
  }
  

• 检查Step的业务逻辑：比如Reader有没有设置正确的终止条件（比如JdbcCursorItemReader是否会读到末尾）、Processor/Writer有没有无限循环的代码。

Spring Batch默认不允许重复执行同一个JobInstance（即相同的JobParameters），如果每次调度都用相同的参数，作业可能会直接跳过，但调度器仍会每隔5秒触发一次，看起来也像“循环”。

解决办法是每次调度生成唯一的JobParameters，比如用时间戳：

private JobParameters buildUniqueJobParams() {
    return new JobParametersBuilder()
            .addLong("trigger-timestamp", System.currentTimeMillis())
            .toJobParameters();
}

如果你的JobLauncher配置了异步TaskExecutor，jobLauncher.run()方法会立刻返回，调度器会误认为上一次作业已经完成，马上触发下一次，导致重叠。

如果需要同步执行作业（即等作业完成再返回），确保JobLauncher是同步配置：

@Bean
public JobLauncher syncJobLauncher(JobRepository jobRepository) {
    SimpleJobLauncher launcher = new SimpleJobLauncher();
    launcher.setJobRepository(jobRepository);
    // 不要设置TaskExecutor，默认就是同步执行
    return launcher;
}

优先从第1、2点排查，这两个是最常见的导致该问题的原因。

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