用途:为 Vercel cron 任务、Next.js API 路由处理器和后端周期任务提供定时任务管理规范,适用于创建或审查 cron 作业、添加 vercel.json 条目、编写 /api/cron/* 处理器、实现后端周期任务等场景。
主要能力:给出定时任务四条核心规则——鉴权(每个 cron 端点校验 CRON_SECRET)、幂等(重复执行结果一致)、可观测(记录开始、结束、耗时与结果)、防重叠(并发调用不破坏共享状态)。提供 Next.js 路由处理器模板、路由文件位置约定、Vercel cron 注册方式、CRON_SECRET 校验写法、数据库锁与内存标志两种防重叠模式、cron_locks 表结构、FastAPI + asyncio 生命周期与 APScheduler 集成、cron 表达式参考与 AEST/AEDT 时区换算、幂等写法、结构化日志与失败告警、反模式清单及新任务检查清单。
使用方式:在 apps/web/app/api/cron/{job-name}/route.ts 创建处理器,在 apps/web/vercel.json 的 crons 数组注册路径与 schedule,处理器顶部校验 Bearer CRON_SECRET,按需加入锁与日志。后端可用 AsyncIOScheduler 配合 CronTrigger,并设置 timezone="Australia/Brisbane"。
限制:资料未提供安装命令、依赖版本、价格与平台支持范围;Vercel cron 以 UTC 运行,需自行换算时区;示例中的 Supabase、logger 等为项目内既有依赖,未说明通用替代方案。