本文介绍使用 spring 的 @scheduled 注解配合 cron 表达式，实现每日固定时刻（如 21:00）自动执行 java 方法；支持时区配置，并具备任务错失后自动跳过、次日准时重试的健壮性机制。
本文介绍使用 spring 的 @scheduled 注解配合 cron 表达式，实现每日固定时刻（如 21:00）自动执行 java 方法；支持时区配置，并具备任务错失后自动跳过、次日准时重试的健壮性机制。
在 Spring Boot 应用中，若需每天在特定时间（例如北京时间 21:00 或巴黎时间 21:00）执行一个业务方法（如数据同步、日志归档、报表生成），推荐使用 @Scheduled 注解配合 Quartz 风格的 Cron 表达式。该方案轻量、声明式、可维护性强，且天然支持时区隔离与应用生命周期集成。
✅ 前提条件：
- 项目已启用 Spring 定时任务支持（在主启动类或配置类上添加
@EnableScheduling）； - 方法必须定义在由 Spring 管理的 Bean 中（如
@Service、@Component类）； - 方法不能有参数，且返回类型应为
void（或可忽略返回值）。
✅ 示例代码：
@Service
public class DailyTaskService {
@Scheduled(cron = "0 0 0 * * ?", zone = "Asia/Shanghai") // 每天 00:00（北京时间）执行
public void executeDailyCleanup() {
System.out.println("✅ 执行每日清理任务 - " + LocalDateTime.now());
// 此处放置你的业务逻辑，如数据库清理、文件归档等
}
}? Cron 表达式说明（6 位 Quartz 格式）："0 0 0 * * ?" 对应含义为：秒=0，分=0，时=0（即 00:00），日=（每天），月=（每月），周=?（不指定星期，避免冲突）。
⚠️ 注意：Spring 默认使用服务器本地时区；若需跨时区精准调度（如部署在 UTC 服务器但面向中国用户），务必显式指定 zone 属性（如 "Asia/Shanghai" 或 "Europe/Paris"），否则可能因时区偏差导致执行时间偏移。
? 关于“错失执行”的处理：
Spring 的 @Scheduled 默认采用 fixed-delay 或 cron 触发模型，其本质是基于定时器轮询触发。若应用在预定时间未运行（如机器休眠、服务宕机），该次任务将直接跳过，不会补偿执行——这正符合你提出的“若时间错过则顺延至次日执行”的需求（即不补漏、只保下一次准时）。如需错失任务补偿（如重启后补跑），需额外引入持久化任务调度器（如 Quartz + JDBC JobStore），但会显著增加复杂度，日常场景中非必需。
✅ 最佳实践建议：
立即学习“Java免费学习笔记（深入）”；
- 在
application.properties中开启定时任务调试日志：logging.level.org.springframework.scheduling=DEBUG
- 避免在
@Scheduled方法中执行长时间阻塞操作；如有耗时逻辑，请考虑异步化（@Async）或拆分为子任务； - 生产环境建议结合健康检查与监控告警（如通过 Actuator
/actuator/scheduledtasks端点查看任务状态）。
综上，@Scheduled(cron = "...", zone = "...") 是实现“每日准点执行、错失即跳过、长期稳定运行”这一需求的简洁、可靠且 Spring 原生推荐的方案。
