Spring Batch定时任务未执行Job及无数据库数据输出排查

1. 检查定时任务中JobLauncher的调用逻辑 #

定时任务的perform方法必须正确调用jobLauncher.run(job, jobParameters)，且需保证每次执行的JobParameters唯一（比如添加时间戳参数）——Spring Batch默认不会重复执行参数完全相同的Job实例。示例正确调用代码：

@Scheduled(fixedRate = 10000)
public void perform() throws Exception {
    JobParameters jobParameters = new JobParametersBuilder()
            .addLong("timestamp", System.currentTimeMillis())
            .toJobParameters();
    jobLauncher.run(myJob, jobParameters);
}

2. 确认Spring Batch自动配置与依赖有效性 #

• 检查application.yml中是否存在spring.batch.job.enabled=false，该配置会禁用自动启动Job，但不影响手动调用，若配置错误可能导致Job实例无法正常初始化。
• 验证pom.xml中依赖是否完整：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-batch</artifactId>
    </dependency>
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

3. 验证Job与Step的Bean定义正确性 #

确保Batch配置类中，Job、Step、ItemReader/Writer的关联逻辑正确：

• ItemReader需配置正确的关联查询SQL，确保能从MySQL读取到数据；
• Step需正确绑定Reader和Writer，且事务管理器、JobRepository注入符合版本要求（Spring Boot 3.x需构造注入，不能用@Autowired）；
• Job需正确关联Step。示例核心配置：

@Bean
public JdbcCursorItemReader<YourEntity> itemReader(DataSource dataSource) {
    return new JdbcCursorItemReaderBuilder<YourEntity>()
            .dataSource(dataSource)
            .sql("SELECT t1.id, t1.name, t2.detail FROM table1 t1 JOIN table2 t2 ON t1.id = t2.t1_id")
            .rowMapper(new BeanPropertyRowMapper<>(YourEntity.class))
            .name("yourEntityReader")
            .build();
}

@Bean
public ItemWriter<YourEntity> itemWriter() {
    return items -> items.forEach(System.out::println);
}

@Bean
public Step myStep(JobRepository jobRepository, PlatformTransactionManager transactionManager,
                   ItemReader<YourEntity> itemReader, ItemWriter<YourEntity> itemWriter) {
    return new StepBuilder("myStep", jobRepository)
            .<YourEntity, YourEntity>chunk(10, transactionManager)
            .reader(itemReader)
            .writer(itemWriter)
            .build();
}

@Bean
public Job myJob(JobRepository jobRepository, Step myStep) {
    return new JobBuilder("myJob", jobRepository)
            .start(myStep)
            .build();
}

4. 检查Spring Batch元数据表状态 #

Spring Batch依赖元数据表（如BATCH_JOB_INSTANCE、BATCH_JOB_EXECUTION等）跟踪Job执行状态。开发环境可通过配置spring.batch.jdbc.initialize-schema=always让Spring Boot自动创建这些表；生产环境建议手动初始化表结构，确保数据库连接权限正常。

5. 调整日志级别排查细节 #

在application.yml中开启Spring Batch相关日志的DEBUG级别，查看Job启动、数据读取的详细日志：

logging:
  level:
    org.springframework.batch: DEBUG
    org.springframework.jdbc: DEBUG

通过日志可确认JobExecution是否创建、Step是否执行、ItemReader是否读取到数据等关键信息。

6. 确认组件的Spring容器注册状态 #

• 定时任务所在类需添加@Component或@Service注解，确保被Spring容器扫描；
• Job、Step等Bean需在配置类中正确定义（添加@Configuration注解），保证能被定时任务类正确注入。

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