本文介绍如何使用 spring 的 `trigger` 接口自定义调度逻辑，使 @scheduled 任务严格在每秒的指定毫秒时刻（如 900ms）准时触发，脱离系统启动时间依赖，满足高精度定时场景需求。
Spring Boot 的 @Scheduled 注解默认支持 cron、fixedDelay 和 fixedRate 等简单调度方式，但它们均无法满足“每秒固定毫秒偏移”这一精细时间控制需求。例如，要求任务严格在每秒的第 900 毫秒（即 :xx:xx:xx.900）执行，且不随应用启动时间漂移——这超出了 cron 表达式的秒级粒度能力（cron 最小单位为秒），也不同于 fixedRate = 1000 那样以上一次执行开始/结束时间为基准的相对间隔。
要实现绝对时间对齐（即“墙上时钟对齐”），必须绕过声明式注解，转而采用 Spring 的底层调度扩展机制：自定义 Trigger 实现类，并配合 SchedulingConfigurer 编程式注册任务。
✅ 核心思路：基于 CronTrigger 做毫秒偏移修正
我们可继承 Spring 内置的 CronTrigger，在其 nextExecutionTime() 方法中，将原始计算出的“整秒时刻”（如 20:00:01:000）统一加上指定毫秒偏移（如 +900ms），从而得到目标时间点（20:00:01:900）。示例实现如下：
public class OffsetCronTrigger extends CronTrigger {
private final long offsetMs;
public OffsetCronTrigger(String cronExpression, long offsetMs) {
super(cronExpression);
if (offsetMs < 0 || offsetMs >= 1000) {
throw new IllegalArgumentException("offsetMs must be in [0, 999]");
}
this.offsetMs = offsetMs;
}
@Override
public Date nextExecutionTime(TriggerContext triggerContext) {
Date baseTime = super.nextExecutionTime(triggerContext);
if (baseTime == null) return null;
// 关键：在整秒时间点上增加固定毫秒偏移
return new Date(baseTime.getTime() + offsetMs);
}
}⚠️ 重要注意事项：
- 此实现假设任务执行耗时远小于 1 秒（即不会阻塞下一次调度）。若任务可能超时，需改用 triggerContext.lastScheduledExecutionTime() 作为基准，而非依赖 super.nextExecutionTime() 的链式逻辑，否则可能累积误差或跳过触发。
- CronTrigger 默认基于上一次实际完成时间推算下次执行，而我们希望始终锚定系统时钟的整秒边界。因此，推荐搭配 * * * ? * *（每秒触发）的 cron 表达式，确保基础频率准确。
✅ 编程式注册：启用自定义 Trigger
需禁用默认的 @Scheduled 自动扫描，改用 SchedulingConfigurer 手动注册带偏移的触发器：
@Configuration
@EnableScheduling
public class SchedulerConfig implements SchedulingConfigurer {
@Override
public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
String everySecondCron = "* * * ? * *"; // 每秒触发一次（整秒时刻）
long offsetMs = 900; // 偏移 900ms → 实际在 xx:xx:xx.900 执行
taskRegistrar.addTriggerTask(
() -> System.out.println("Executed at: " + LocalDateTime.now().format(DateTimeFormatter.ofPattern("HH:mm:ss.SSS"))),
new OffsetCronTrigger(everySecondCron, offsetMs)
);
}
}✅ 启动后，日志将稳定输出类似：
Executed at: 14:25:00.900 Executed at: 14:25:01.900 Executed at: 14:25:02.900
✅ 进阶建议
- 若需更高精度（亚毫秒级）或强实时性，应考虑 ScheduledExecutorService 配合 System.nanoTime() 手动对齐，或引入 Quartz（支持毫秒级 cron 扩展）；
- 生产环境建议添加任务执行耗时监控与超时熔断逻辑，避免长任务拖垮调度节奏；
- 可封装为 @EnableOffsetScheduling 自定义注解 + ImportBeanDefinitionRegistrar，提升复用性。
通过自定义 Trigger，你完全掌控了每次调度时间的计算逻辑，既保持了 Spring 调度框架的集成优势，又突破了原生注解的精度限制——这是构建金融对账、实时采样、IoT 同步等高精度定时系统的可靠实践路径。
