@Scheduled适用于简单单机定时任务,Quartz支持集群调度、动态Cron等高级功能;使用Quartz集群必须正确配置4个关键参数,动态修改Cron需通过TaskScheduler编程实现,数据库表初始化需注意版本匹配、大小写及schema问题。

Spring Boot 里该选 @Scheduled 还是 Quartz?
如果只是每小时跑一次统计、每天凌晨清理日志,@Scheduled 足够了;一旦要支持暂停/恢复、集群调度、失败重试、动态修改 cron 表达式,就得上 Quartz。
-
@Scheduled本质是单机线程池调度,应用重启后任务状态全丢,集群下会重复执行 - Quartz 内置
JobStoreTX(JDBC 存储)才能保证集群一致性,别用默认的内存版RAMJobStore - Spring Boot 2.3+ 默认禁用
@Scheduled,得在启动类加@EnableScheduling或配置spring.task.scheduling.enabled=true
Quartz 集群模式下必须配对的 4 个关键配置项
只配 org.quartz.jobStore.class=org.quartz.impl.jdbcjobstore.JobStoreTX 不顶用,漏掉任意一个都会退化成单机行为或报错。
-
org.quartz.jobStore.driverDelegateClass:MySQL 用org.quartz.impl.jdbcjobstore.StdJDBCDelegate,PostgreSQL 得换PostgreSQLDelegate -
org.quartz.jobStore.tablePrefix:默认QRTZ_,但如果你的表名是quartz_job_detail,就得设成quartz_ -
org.quartz.jobStore.isClustered:必须为true,否则节点间不通信 -
org.quartz.jobStore.clusterCheckinInterval:建议设为 15000(15 秒),太小加重 DB 压力,太大导致故障发现延迟
Spring Task 动态修改 cron 的安全写法
直接改 @Scheduled(cron = "...") 注解里的字符串没用——它在编译期就固化了。真要动态,得绕开注解,用 TaskScheduler 编程式注册。
- 注入
ThreadPoolTaskScheduler,调用schedule(Runnable, Trigger),其中CronTrigger构造时传入可变的 cron 字符串 - 旧任务必须先
cancel(),再重新schedule(),否则残留任务会和新任务冲突 - 别在 Controller 里直接 new
CronTrigger并 schedule——没做线程安全防护,高并发下可能漏触发或重复触发 - 示例:
taskScheduler.schedule(() -> doWork(), new CronTrigger("0 0 * * * ?"));
Quartz 数据库表初始化失败的三个高频原因
执行 quartz-2.3.2.jar 里的 SQL 脚本后,应用一启动就抛 Table 'QRTZ_JOB_DETAILS' doesn't exist,大概率不是脚本没跑,而是环境错位。
立即学习“Java免费学习笔记(深入)”;
- 脚本版本和 Quartz 版本不匹配:2.3.x 用
tables_mysql_innodb.sql,3.x 改用tables_mysql.sql(去掉了 InnoDB 强制约束) - 数据库大小写敏感:Linux 下 MySQL 默认区分表名大小写,而 Quartz 脚本全大写,但你的表名被建成了小写(比如用 GUI 工具手动执行时自动转小写)
- schema 名没指定:脚本里所有
CREATE TABLE都没带database_name.前缀,如果连接 URL 没默认 schema(如jdbc:mysql://x/x?useSSL=false),表会建到information_schema或空库下
复杂点在于 Quartz 的集群心跳依赖 QRTZ_FIRED_TRIGGERS 表的 INSTANCE_NAME 字段做唯一性判断,这个字段如果被截断(比如你设了 varchar(50) 但实际实例名超长),整个集群会静默失效。










