Kotlin Spring Boot中Spring Batch任务启动未执行问题修复咨询

问题根源分析 #

你的代码和配置存在两个核心问题：

1. Bean依赖管理不当：直接调用@Bean方法获取实例，可能引发Scope生命周期异常；
2. 缺少数据库配置：Spring Batch需要数据库存储任务元数据，无有效数据源时JobRepository无法正常工作。

修复步骤及代码示例 #

1. 修正Batch配置类的依赖注入方式 #

改用参数注入获取Bean，确保Spring正确管理Bean生命周期，同时遵循Kotlin命名规范：

import mu.KotlinLogging
import org.springframework.batch.core.Job
import org.springframework.batch.core.Step
import org.springframework.batch.core.configuration.annotation.EnableBatchProcessing
import org.springframework.batch.core.configuration.annotation.StepScope
import org.springframework.batch.core.job.builder.JobBuilder
import org.springframework.batch.core.repository.JobRepository
import org.springframework.batch.core.step.builder.StepBuilder
import org.springframework.batch.core.step.tasklet.Tasklet
import org.springframework.batch.repeat.RepeatStatus
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.transaction.PlatformTransactionManager

private val log = KotlinLogging.logger {}

@EnableBatchProcessing
@Configuration
class BatchConfig(
    private val jobRepository: JobRepository,
    private val transactionManager: PlatformTransactionManager
) {
    @Bean
    fun taskletJob(step: Step): Job {
        return JobBuilder("taskletJob", jobRepository)
            .start(step)
            .build()
    }

    @Bean
    fun taskletStep(tasklet: Tasklet): Step {
        return StepBuilder("taskletStep", jobRepository)
            .tasklet(tasklet, transactionManager)
            .build()
    }

    @Bean
    @StepScope
    fun tasklet(): Tasklet {
        return Tasklet { _, _ ->
            log.info { "test batch" }
            RepeatStatus.FINISHED
        }
    }
}

2. 补充完整的数据源配置 #

在application.yml中添加数据库配置（以H2内存数据库为例，适合快速测试）：

spring:
  datasource:
    url: jdbc:h2:mem:testdb
    username: sa
    password:
    driver-class-name: org.h2.Driver
  batch:
    jdbc:
      initialize-schema: always
    job:
      enabled: true
      allow-start-if-complete: true # 可选：允许任务重复执行，每次启动都运行

修复说明 #

• 依赖注入调整：通过参数注入Step和Tasklet，避免直接调用@Bean方法可能导致的Scope实例化异常，确保@StepScope的Bean在任务执行时才被正确初始化。
• 数据源配置：Spring Batch必须依赖数据库存储任务执行的元数据（如任务实例、执行状态等），无有效数据源时，JobRepository无法初始化，任务自然无法启动。
• 重复执行配置：allow-start-if-complete: true可以让任务在每次应用启动时都执行，默认情况下Spring Batch会跳过已完成的任务。

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