Spring Batch中JobBuilder与StepBuilder无法自动注入的问题排查

问题原因 #

JobBuilder和StepBuilder并非Spring容器管理的Bean，不能直接通过@Autowired注入。这两个是构建器类，需要依赖JobRepository（Step还需要PlatformTransactionManager）来实例化。

修正后的代码 #

1. 修改SampleJob配置类 #

无需注入JobBuilder和StepBuilder，改为注入JobRepository和PlatformTransactionManager，用它们创建对应的构建器：

package com.example.config;

import org.springframework.batch.core.Job;
import org.springframework.batch.core.Step;
import org.springframework.batch.core.StepContribution;
import org.springframework.batch.core.job.builder.JobBuilder;
import org.springframework.batch.core.repository.JobRepository;
import org.springframework.batch.core.scope.context.ChunkContext;
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;

@Configuration
public class SampleJob {

    private final JobRepository jobRepository;
    private final PlatformTransactionManager transactionManager;

    // 构造注入（Spring官方推荐方式）
    public SampleJob(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
        this.jobRepository = jobRepository;
        this.transactionManager = transactionManager;
    }

    @Bean
    public Job firstJob() {
        return new JobBuilder("First Job", jobRepository)
                .start(firstStep())
                .build();
    }

    @Bean
    Step firstStep() {
        return new StepBuilder("First Step", jobRepository)
                .tasklet(firstTask(), transactionManager)
                .build();
    }

    private Tasklet firstTask() {
        return (stepContribution, chunkContext) -> {
            System.out.println("This is first tasklet step");
            return RepeatStatus.FINISHED;
        };
    }
}

2. 启动类保持原样 #

原启动类的@EnableBatchProcessing会自动配置JobRepository、PlatformTransactionManager等核心组件，无需额外修改。

关键说明 #

• @EnableBatchProcessing注解会自动装配Spring Batch核心依赖，包括构建Job/Step必需的JobRepository和事务管理器。
• 废弃的JobBuilderFactory/StepBuilderFactory已被直接使用JobBuilder/StepBuilder构造函数的方式替代。
• 构造注入优于字段注入，更便于测试和依赖管理，是Spring官方推荐的注入方式。

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