如何记录动态Cron表达式配置的Spring Scheduler触发时间

嘿，你已经把动态Cron表达式的调度配置搞定了，现在就差记录每次调度的触发时间对吧？这里有几个实用的方案，你可以按需选择：

这是最简单直接的方式，因为调度方法每次触发都会执行，直接在方法开头添加日志记录即可，还能结合你配置的时区保证时间准确性：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.time.LocalDateTime;
import java.time.ZoneId;

// 你的调度类
public class YourSchedulerClass {
    @Autowired 
    private PurgeProperties purgeProperties;

    private static final Logger log = LoggerFactory.getLogger(YourSchedulerClass.class);

    @Scheduled(cron = "#{@purgeProperties.cronExpression}", zone = "#{@purgeProperties.zone}")
    public void purgeData() throws UnknownHostException {
        // 用配置的时区记录触发时间，避免时区偏差
        LocalDateTime triggerTime = LocalDateTime.now(ZoneId.of(purgeProperties.getZone()));
        log.info("PurgeData调度器触发，时间：{}", triggerTime);
        
        startPurge();
    }

    // 你的startPurge方法
    private void startPurge() {
        // 业务逻辑
    }
}

这个方案的优势是零额外配置，快速实现；缺点是日志代码和业务代码耦合在一起，如果后续有多个任务需要记录，会重复写日志逻辑。

如果想把调度配置和业务逻辑分离，或者需要更灵活的调度控制，可以实现SchedulingConfigurer接口来注册任务，同时在注册时添加触发记录：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.SchedulingConfigurer;
import org.springframework.scheduling.config.CronTask;
import org.springframework.scheduling.config.ScheduledTaskRegistrar;
import java.time.LocalDateTime;
import java.time.ZoneId;

@Configuration
public class CustomSchedulerConfig implements SchedulingConfigurer {

    private static final Logger log = LoggerFactory.getLogger(CustomSchedulerConfig.class);
    private final PurgeProperties purgeProperties;
    private final YourSchedulerClass schedulerBean;

    // 构造注入，推荐替代字段注入
    public CustomSchedulerConfig(PurgeProperties purgeProperties, YourSchedulerClass schedulerBean) {
        this.purgeProperties = purgeProperties;
        this.schedulerBean = schedulerBean;
    }

    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        // 构建Cron任务，先记录触发时间再执行业务方法
        CronTask cronTask = new CronTask(() -> {
            try {
                LocalDateTime triggerTime = LocalDateTime.now(ZoneId.of(purgeProperties.getZone()));
                log.info("PurgeData调度器触发，时间：{}", triggerTime);
                
                schedulerBean.purgeData();
            } catch (UnknownHostException e) {
                log.error("PurgeData调度执行失败", e);
            }
        }, purgeProperties.getCronExpression(), ZoneId.of(purgeProperties.getZone()));

        taskRegistrar.addCronTask(cronTask);
    }
}

注意：使用这个方案时，需要移除原来调度方法上的@Scheduled注解，因为任务已经通过SchedulingConfigurer手动注册了。

这个方案的优势是调度逻辑和业务逻辑分离，便于统一管理多个任务；缺点是需要额外编写配置类，适合有多个调度任务需要统一处理的场景。

Spring Scheduler会在任务触发时发布ScheduledTaskStartedEvent事件，我们可以通过监听这个事件来实现完全无侵入的触发时间记录：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.ApplicationListener;
import org.springframework.scheduling.annotation.ScheduledTaskStartedEvent;
import org.springframework.stereotype.Component;
import java.time.LocalDateTime;
import java.time.ZoneId;

@Component
public class SchedulerTriggerListener implements ApplicationListener<ScheduledTaskStartedEvent> {

    private static final Logger log = LoggerFactory.getLogger(SchedulerTriggerListener.class);
    private final PurgeProperties purgeProperties;

    public SchedulerTriggerListener(PurgeProperties purgeProperties) {
        this.purgeProperties = purgeProperties;
    }

    @Override
    public void onApplicationEvent(ScheduledTaskStartedEvent event) {
        // 识别目标任务：通过任务所属类和方法名判断
        Runnable taskRunnable = event.getTask().getRunnable();
        Class<?> taskClass = taskRunnable.getClass().getEnclosingClass();
        String methodName = taskRunnable.getClass().getEnclosingMethod().getName();

        if (YourSchedulerClass.class.equals(taskClass) && "purgeData".equals(methodName)) {
            LocalDateTime triggerTime = LocalDateTime.now(ZoneId.of(purgeProperties.getZone()));
            log.info("任务[purgeData]触发，时间：{}", triggerTime);
        }
    }
}

这个方案的优势是完全不侵入业务代码，适合需要全局监控所有调度任务的场景；缺点是需要准确识别目标任务，避免误记录其他任务的触发事件。

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