成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Vercel Cron Jobs 调用 Function 配置简报

按 vercel.json crons 路径、UTC cron、CRON_SECRET Bearer 校验与 x-vercel-cron-schedule,整理定时打 Function 的配置简报;不代改生产 cron。

场景说明

面向个人效率与独立开发者:把「定时打自己的 API Route」写成可对账步骤,明确区别于 Cloudflare Workers scheduled 触发器。

案例叙事

01他们做了什么

个人工具想每天汇总邮件或刷新缓存,已有 Next.js Route Handler,却不想再开一台机器跑 crontab——希望平台按时 GET 自己的路径。

Vercel Docs《Cron Jobs》说明:Cron Jobs 用 cron 表达式定义重复任务频率与时机;常见用途包括备份归档、发邮件/Slack 通知、更新 Stripe 订阅数量等。Vercel 为 Vercel Functions 提供 Cron Jobs,可通过 `vercel.json` 或 Build Output API 添加。管理侧文档补充:可添加环境变量 `CRON_SECRET`(建议至少 16 位随机串);调用 cron 时会自动带上 Authorization 头,端点应将其与环境变量比对以验真;头值为 `Bearer` 前缀加密钥。同路径若挂多条 schedule,请求会带 `x-vercel-cron-schedule` 头,值为触发该次调用的 cron 表达式,便于分支全量/增量逻辑。本场景据此输出「路径 + UTC 表达式 + CRON_SECRET」配置简报。禁止声称「生产 cron 已生效」。

02实际效果

  • 源未披露量化「定时任务成功率」;公开文只描述 Functions 定时、vercel.json、UTC 示例与 CRON_SECRET 验真。
  • 能把「表达式时区错 / 未校验 Bearer / 同路径多 schedule 未读头」拆开排查。
  • 与 Cloudflare Workers Cron Trigger 边界清晰,避免两套平台话术混写。

03值得知道

  • 时长、并发、定价与表达式限制见 Managing / Usage 文档,随套餐变化。
  • 仅保护路径不够:密钥须放环境变量且按 Secret 治理,勿写入仓库。
  • 上面写的是文档配置路径,不是你项目当前的 crons 实况。

04可复制提示词

Vercel Cron 配置简报

你是 Vercel Cron Jobs 助手。只给配置核对简报,不要编造已调度成功。

目标日程(含用户时区):{{schedule_local}}
Function 路径:{{function_path}}
vercel.json crons 片段:{{crons_snippet}}
是否已设 CRON_SECRET:{{has_cron_secret}}

输出 Markdown:
1. path/schedule 字段核对
2. 换算后的 UTC 表达式候选与提问
3. Bearer 校验伪代码级检查点(不要索要真实密钥)
4. 同路径多 schedule 时如何读 x-vercel-cron-schedule
5. 预发验收步骤
禁止代部署;禁止与 Cloudflare Workers scheduled 混写步骤。

Cron 401/未触发排查提纲

预期时间未执行或日志大量 401,请写排查提纲。

期望时间:{{expected_time}}
路径:{{path}}
鉴权实现摘要:{{auth_brief}}

输出:
1. UTC 是否算错
2. Authorization 是否按 Bearer 比对
3. 变量是否仅在错误 Environment
4. 下一步人工验证
不要伪造「已触发成功」。

05一手来源

Vercel Documentation · Cron Jobs ↗

文档更新

怎么做

  1. 粘贴目标日程(含时区)、Function/Route 路径、vercel.json crons 片段与是否已设 CRON_SECRET
  2. Agent 按官方 Cron Jobs 说明输出:vercel.json 映射→UTC 表达式→Bearer 鉴权→同路径多 schedule 头区分提问清单
  3. 人工提交配置并在预发验证;Agent 不代部署生产

实用提示

  • 平台示例以 UTC 解释表达式;墙钟需先换算。调用时可带 Authorization: Bearer $CRON_SECRET,路由应比对后拒绝未授权
  • 与 cloudflare-workers-cron-trigger-brief 不同:本条是 Vercel Functions + vercel.json path,不是 Worker `scheduled()` / wrangler triggers
#Vercel#Cron Jobs#CRON_SECRET#Functions#个人效率