Quartz的CronTrigger时间不准根本原因是默认时区与调度器启动时机未对齐,解析表达式时按JVM默认时区偏移而非系统或启动时间时区;Job中@Autowired失效因Quartz反射创建实例不走Spring容器;SimpleTrigger适用于固定间隔场景,CronTrigger适用于含日历语义(如L、#、W)的触发;集群重复执行多因数据库锁未生效,需确认isClustered=true、LOCKS表存在、用户有SELECT FOR UPDATE权限且不用H2/HSQLDB。

Quartz的CronTrigger为什么总少跑一次或时间不准
根本原因不是表达式写错,而是默认时区和调度器启动时机没对齐。Quartz内部用java.util.Date做时间计算,但CronTrigger解析表达式时会按JVM默认时区(不是系统时区,也不是new CronTrigger().getStartTime()那个时间点的时区)做偏移。比如你在UTC+8环境部署,却没显式设时区,Quartz可能按UTC解析0 0 2 * * ?,结果任务在凌晨10点执行。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 所有
CronScheduleBuilder.cronSchedule()必须链式调用.inTimeZone(TimeZone.getTimeZone("Asia/Shanghai")) - 避免用
SchedulerFactoryBean.setStartupDelay(5)这类延迟启动——它只推迟调度器初始化,不重算触发时间,容易导致首次触发跳过 - 上线前用
CronExpression.getNextValidTimeAfter(new Date())手动验证下最近三次触发时间,别只信在线生成器
Job类里不能直接用Spring Bean?@Autowired失效怎么办
因为Quartz自己管理Job实例生命周期,不会走Spring容器创建流程。你写的MyJob implements Job会被Quartz反射new出来,Spring根本不知道这个对象存在。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 别在
Job.execute()里直接@Autowired任何东西,字段永远是null - 改用
JobDataMap传Bean:在调度前调用jobDetail.getJobDataMap().put("service", applicationContext.getBean(MyService.class)) - 更稳妥的是让Job继承
QuartzJobBean,重写executeInternal(),并在Spring配置里用MethodInvokingJobDetailFactoryBean包装 - 注意
JobDataMap里的对象必须可序列化,否则集群模式下会抛NotSerializableException
SimpleTrigger和CronTrigger到底该选哪个
不是看“复杂不复杂”,而是看触发逻辑是否依赖日历语义。比如“每5秒执行”是SimpleTrigger的主场;但“每月最后一个周五下午3点”必须用CronTrigger——SimpleTrigger压根没有“月尾”“工作日”概念。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 固定间隔、固定次数、无日期逻辑的场景,优先用
SimpleTrigger:性能高、调试简单、集群下误差小 - 只要表达式里出现
L(最后)、#(第几个)、W(工作日)或跨月/年逻辑,立刻切到CronTrigger - 别为了“看起来高级”硬套Cron:像
0/30 * * * * ?这种纯间隔场景,用SimpleTrigger更稳,Cron反而因时区/夏令时多一层风险
集群环境下Job重复执行?数据库锁没生效
常见现象是两个节点同时触发同一个Job,不是Quartz没锁,而是数据库表没配对、事务隔离级别太低,或者没关掉org.quartz.jobStore.isClustered = false。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 确认
quartz.properties里org.quartz.jobStore.isClustered = true且org.quartz.jobStore.clusterCheckinInterval = 20000(别设成60000以上) - 检查
QRTZ_LOCKS表是否存在,以及应用连接数据库的用户是否有SELECT FOR UPDATE权限(MySQL要开READ-COMMITTED,PostgreSQL需REPEATABLE READ) - 别用H2或HSQLDB做集群存储——它们不支持行级锁竞争,测试可以,上线必出问题
- 如果Job执行时间常超
clusterCheckinInterval,Quartz会认为节点挂了而转移任务,此时得调大org.quartz.jobStore.misfireThreshold
时区、Bean注入、触发器选型、集群锁——这四个点卡住90%的Quartz线上问题。细节都在配置和边界条件里,不在文档第一行。


















