如何在Spring Boot应用启动时自动调度Quartz Cron定时任务

核心问题排查与修复步骤 #

• 1. 修复Cron表达式测试有效性
     你当前配置的TestJob Cron表达式为* 0 0 ? * * *，仅会在每日00:00的整分钟时段内每秒执行，若测试时不在该时段自然不会触发任务。测试阶段可先替换为每10秒执行的表达式验证功能：

// CronExpression类修改
.put(TestJob.CLASS_NAME, "0/10 * * * * ?")

• 2. 打开SchedulerFactoryBean的数据源注入配置
     你在ConfigQuartz的schedulerFactoryBean方法中注释掉了factory.setDataSource(dataSource);，你使用JDBC类型的JobStore持久化任务，必须给Scheduler注入数据源才能正常读写Quartz表数据，直接取消该行注释即可：

@Bean
public SchedulerFactoryBean schedulerFactoryBean(DataSource dataSource, JobFactory jobFactory) throws IOException {
    SchedulerFactoryBean factory = new SchedulerFactoryBean();
    factory.setOverwriteExistingJobs(true);
    factory.setAutoStartup(isQuartzEnabled);
    factory.setDataSource(dataSource); // 取消注释
    factory.setJobFactory(jobFactory);
    factory.setQuartzProperties(quartzProperties());
    factory.setTriggers(triggers.toArray(new Trigger[triggers.size()]));
    return factory;
}

• 3. 修复JobDetail实例化缺失初始化调用的问题
     你的createJobDetail静态方法只做了参数配置，没有执行FactoryBean的初始化方法，直接调用getObject会返回null，导致触发器绑定的任务为空：

public static JobDetailFactoryBean createJobDetail(Class jobClass) {
    JobDetailFactoryBean factoryBean = new JobDetailFactoryBean();
    factoryBean.setJobClass(jobClass);
    factoryBean.setDurability(true);
    factoryBean.afterPropertiesSet(); // 新增初始化调用
    return factoryBean;
}

• 4. 修复Bean加载顺序问题
     你把JobDetail和Trigger的@Bean定义写在了TestJob这个@Component类中，Spring加载顺序如果先实例化SchedulerFactoryBean，此时triggers静态列表还未被填充，会导致Scheduler拿不到任何触发器。可以给schedulerFactoryBean添加@DependsOn注解，强制先加载任务和触发器的Bean：

@Bean
@DependsOn({"TestJob_QUARTZ_JOB_SUFFIX", "TestJob_QUARTZ_TRIGGER_SUFFIX"}) // 替换为你AppConstants里对应后缀拼接后的实际Bean名
public SchedulerFactoryBean schedulerFactoryBean(DataSource dataSource, JobFactory jobFactory) throws IOException {
    // 原有逻辑不变
}

更稳妥的方案是把所有Job、Trigger的Bean定义统一放到配置类中，避免分散在Job实现类里导致的加载顺序问题。

• 5. 测试阶段可关闭集群配置避免冲突
     你当前quartz.properties中开启了集群模式，且instanceId写死为10，若本地多次启动或者有其他同实例ID的服务运行会导致调度冲突，测试阶段可以先关闭集群，或者把instanceId改为自动生成：

# quartz.properties修改
org.quartz.jobStore.isClustered = false
# 或者保留集群开启，修改instanceId配置
org.quartz.scheduler.instanceId = AUTO

验证步骤 #

完成以上修改后启动应用，查看Quartz对应的数据表：qrtz_job_details、qrtz_triggers中是否已经写入了你的TestJob相关数据，若数据正常写入且Cron表达式配置正确，任务就会按规则触发。

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