部署运维

Quartz 定时任务:配置、日志与幂等

在 eladmin 里新增一个定时任务,设置 cron,查看执行日志,以及避免任务重复执行的注意点。

约 2 分钟360 字

定时任务常见于数据同步、报表统计、缓存刷新。eladmin 整合了 Quartz,支持在系统界面管理任务与查看日志。

新增任务

在系统的定时任务页面新建任务,填写 Bean 名称(对应 Spring Bean)、方法名与 cron 表达式。框架按配置在指定时间调用目标方法,并记录执行结果到任务日志。

0 0 2 * * ?     # 每天凌晨 2 点执行

幂等是关键

定时任务可能因重启、失败重试而重复执行。设计任务时保证幂等:用唯一键、状态标记或分布式锁,确保跑一次和跑多次结果一致。涉及金额、库存的任务尤其要小心。

排查思路

任务没执行,先看 cron 是否正确、任务是否启用、服务时间是否同步;执行报错看任务日志与异常日志。多实例部署时,注意是否会导致同一任务在多台机器各跑一遍,需要引入分布式调度或锁。