Spring Batch中JobExecutionListener注入JdbcTemplate空指针问题

问题描述 #

在Spring Boot 3.2.2的Spring Batch项目中，尝试在JobExecutionListener中集成JdbcTemplate时抛出空指针异常：

java.lang.NullPointerException: Cannot invoke "org.springframework.jdbc.core.JdbcTemplate.update(String, Object[])" because "this.jdbcTemplate" is null

已配置自定义DataSource和JdbcTemplate，并在application.properties中声明了数据源属性，CustomJobExecutionListener已添加@Component注解，但注入的JdbcTemplate始终为null。

可能原因及解决方案 #

1. Job配置中手动实例化Listener（最常见原因） #

如果在Job构建时直接new CustomJobExecutionListener()，而非从Spring容器获取实例，该Listener不会被Spring管理，导致@Autowired注入失效。

错误示例：

@Bean
public Job myJob(JobBuilderFactory jobBuilderFactory, Step myStep) {
    return jobBuilderFactory.get("myJob")
            .listener(new CustomJobExecutionListener()) // 手动new，非Spring托管实例
            .flow(myStep)
            .end()
            .build();
}

正确做法：
通过Spring容器注入Listener实例：

@Bean
public Job myJob(JobBuilderFactory jobBuilderFactory, Step myStep, CustomJobExecutionListener listener) {
    return jobBuilderFactory.get("myJob")
            .listener(listener) // 使用Spring托管的Listener实例
            .flow(myStep)
            .end()
            .build();
}

2. JdbcTemplate Bean的注入匹配问题 #

你的JdbcTemplate Bean被命名为JdbcBI（通过@Bean("JdbcBI")指定），如果容器中存在多个JdbcTemplate实例，@Autowired按类型注入会出现歧义，导致注入失败。

解决方案：
在Listener中通过@Qualifier指定要注入的Bean名称：

@Component
public class CustomJobExecutionListener implements JobExecutionListener {
    
    @Autowired
    @Qualifier("JdbcBI") // 指定Bean名称
    JdbcTemplate jdbcTemplate;

    // ... 其他代码
}

3. 优化DataSource配置（避免潜在问题） #

当前手动创建HikariDataSource的方式可能丢失Spring Boot自动配置的Hikari属性（如spring.datasource.hikari下的配置），建议改用DataSourceProperties的构建方法：

修改JdbcTemplateConfig中的dataSource()方法：

@Bean
@Qualifier("bi")
@Primary
public DataSource dataSource() {
    return biDataSourceProperties()
            .initializeDataSourceBuilder()
            .type(HikariDataSource.class)
            .build();
}

同时可以简化JdbcTemplate的创建：

@Bean("JdbcBI")
public JdbcTemplate jdbcTemplate(@Qualifier("bi") DataSource dataSource) {
    return new JdbcTemplate(dataSource);
}

4. 确保组件扫描范围正确 #

确认CustomJobExecutionListener和JdbcTemplateConfig所在的包在Spring Boot主类的@ComponentScan扫描范围内，若不在，需在主类上添加@ComponentScan(basePackages = "你的包路径")或使用@Import导入配置类。

验证步骤 #

1. 启动项目前检查Job配置是否正确注入Listener实例
2. 确认JdbcTemplate Bean已成功创建（可通过Spring Boot Actuator的beans端点查看）
3. 测试Job执行，观察是否仍有空指针异常

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