package com.ruoyi.energymeter.job; import com.ruoyi.energymeter.config.EnergyMeterProperties; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.quartz.CronScheduleBuilder; import org.quartz.CronTrigger; import org.quartz.Job; import org.quartz.JobBuilder; import org.quartz.JobDetail; import org.quartz.JobKey; import org.quartz.Scheduler; import org.quartz.SchedulerException; import org.quartz.Trigger; import org.quartz.TriggerBuilder; import org.quartz.TriggerKey; import org.springframework.boot.ApplicationArguments; import org.springframework.boot.ApplicationRunner; import org.springframework.stereotype.Component; import java.util.TimeZone; /** * 启动时以固定 JobKey/TriggerKey 注册或更新两个 Quartz 作业,重复启动不会产生重复触发器。 */ @Slf4j @Component @RequiredArgsConstructor public class EnergyMeterSchedulerRegistrar implements ApplicationRunner { private static final String GROUP = "energyMeter"; private static final String TIME_ZONE = "Asia/Shanghai"; private final Scheduler scheduler; private final EnergyMeterProperties properties; @Override public void run(ApplicationArguments args) { if (!properties.isSchedulerEnabled()) { log.info("水电表定时任务已关闭(energy-meter.scheduler-enabled=false)"); return; } try { // 清理已下线的电表整点同步作业,避免持久化 Quartz 存储里的旧触发器继续按小时触发 removeIfExists("energyMeterElectricHourlySync", "energyMeterElectricHourlySyncTrigger"); register("energyMeterDailySync", "energyMeterDailySyncTrigger", EnergyMeterDailySyncJob.class, properties.getSyncCron(), "水电表每天08:00自动同步"); register("energyMeterRecovery", "energyMeterRecoveryTrigger", EnergyMeterRecoveryJob.class, properties.getRecoveryCron(), "水电表每10分钟恢复重试"); } catch (Exception e) { log.error("注册水电表定时任务失败", e); } } private void removeIfExists(String jobName, String triggerName) throws SchedulerException { TriggerKey triggerKey = TriggerKey.triggerKey(triggerName, GROUP); if (scheduler.checkExists(triggerKey)) { scheduler.unscheduleJob(triggerKey); log.info("已移除下线的水电表定时任务触发器 {}", triggerName); } JobKey jobKey = JobKey.jobKey(jobName, GROUP); if (scheduler.checkExists(jobKey)) { scheduler.deleteJob(jobKey); log.info("已移除下线的水电表定时任务 {}", jobName); } } private void register(String jobName, String triggerName, Class jobClass, String cron, String description) throws SchedulerException { JobKey jobKey = JobKey.jobKey(jobName, GROUP); TriggerKey triggerKey = TriggerKey.triggerKey(triggerName, GROUP); if (!scheduler.checkExists(jobKey)) { JobDetail jobDetail = JobBuilder.newJob(jobClass) .withIdentity(jobKey) .withDescription(description) .storeDurably() .requestRecovery() .build(); Trigger trigger = buildTrigger(triggerKey, jobKey, cron, description); scheduler.scheduleJob(jobDetail, trigger); log.info("已注册水电表定时任务 {}({},{})", jobName, cron, TIME_ZONE); return; } Trigger existing = scheduler.getTrigger(triggerKey); boolean sameCron = existing instanceof CronTrigger cronTrigger && cron.equals(cronTrigger.getCronExpression()); Trigger.TriggerState state = existing == null ? Trigger.TriggerState.NONE : scheduler.getTriggerState(triggerKey); // 版本升级后旧实例可能不认识新 Job 类而把触发器置为 ERROR,这里重建触发器使其恢复调度 if (!sameCron || state == Trigger.TriggerState.ERROR) { Trigger trigger = buildTrigger(triggerKey, jobKey, cron, description); if (existing != null) { scheduler.unscheduleJob(triggerKey); } scheduler.scheduleJob(trigger); log.info("已重建水电表定时任务 {} 的触发器(cron={},原状态={})", jobName, cron, state); } else { log.info("水电表定时任务 {} 已存在且规则一致,跳过重复注册", jobName); } } private Trigger buildTrigger(TriggerKey triggerKey, JobKey jobKey, String cron, String description) { return TriggerBuilder.newTrigger() .withIdentity(triggerKey) .withDescription(description) .forJob(jobKey) .withSchedule(CronScheduleBuilder.cronSchedule(cron) .inTimeZone(TimeZone.getTimeZone(TIME_ZONE)) .withMisfireHandlingInstructionFireAndProceed()) .build(); } }