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

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

Cloudflare Workers Cron Trigger 配置简报

按 scheduled 处理器、UTC cron 表达式、配置传播延迟与本地试跑入口,生成周期任务配置简报;不代改线上 Worker 触发器。

场景说明

面向独立开发者与个人效率自动化:把「定时跑 Worker」写成可对账步骤,区别于纯云主机 crontab 运维壳。

案例叙事

01他们做了什么

个人站点凌晨清理、定时拉第三方行情或发摘要,常想「丢到 Cloudflare Worker 定时跑」,却卡在:写了 fetch 处理器、cron 不触发,或按北京时间写了表达式实际按 UTC 跑偏。

Cloudflare Docs《Cron Triggers》说明:可用 cron 表达式映射到 Worker 的 `scheduled()` 处理器,适合周期性维护或调用第三方 API 拉数。文档写明 Cron Triggers 按 UTC 执行。添加步骤:先在 Worker 中定义 scheduled 事件监听(JS/TS `async scheduled(controller, env, ctx)` 或 Python Entrypoint 的 scheduled,参数齐全);再更新项目配置中的 triggers/crons(示例含 `*/3 * * * *`、`0 15 1 * *`、`59 23 LW * *` 等,亦可按环境分别设置)。变更(增删改 Cron Trigger)可能需数分钟、最长约 15 分钟传播到 Cloudflare 全球网络。文档还覆盖支持的 cron 表达式、多触发器、本地测试(Local Explorer / HTTP)、查看历史事件与移除触发器,并提示 Workflows 也可直接使用 schedules。本场景据此输出配置简报。禁止声称「线上 cron 已生效」。

02实际效果

  • 源未披露量化「配置一次成功率」;公开文只描述 scheduled 处理器、UTC、传播延迟与本地试跑入口。
  • 能把「没写 scheduled / 时区写错 / 传播未完成」拆开排查。
  • 适合独立开发者轻量定时任务,而非重型集群 crontab 同构检查表。

03值得知道

  • 表达式与平台限额以当前文档 Limits 为准,勿假设与 Linux cron 完全一致。
  • 传播有延迟,刚改完立刻判断「失败」可能过早。
  • 上面写的是文档配置路径,不是你账号下触发器实时状态。

04可复制提示词

Workers Cron 配置简报

你是 Cloudflare Workers Cron 助手。只给配置核对简报,不要编造已部署成功。

目标日程(含用户时区):{{schedule_local}}
Worker 代码摘要:{{worker_brief}}
现有 triggers/crons 片段:{{crons_snippet}}

输出 Markdown:
1. 是否已有 scheduled 处理器
2. 换算后的 UTC cron 候选与提问
3. 配置传播延迟提醒
4. 本地试跑入口建议
5. 值班一句话
禁止代部署;禁止索要 API token。

Cron 未触发排查提纲

预期时间未看到 Worker 被 cron 唤起,请写排查提纲。

期望时间:{{expected_time}}
配置变更时间:{{changed_at}}
日志摘要:{{logs}}

输出:
1. scheduled 是否存在
2. UTC 是否算错
3. 是否仍在传播窗口
4. 下一步人工验证
不要伪造「已触发成功」。

05一手来源

怎么做

  1. 粘贴期望日程(含时区)、现有 Worker 是否已有 scheduled 处理器、配置片段(可打码)
  2. Agent 按文档输出:scheduled 处理器→UTC cron→配置更新与传播窗口→本地测试入口提问清单
  3. 人工在预发/仪表盘变更;Agent 不代部署生产

实用提示

  • Cron Triggers 按 UTC 执行;本地墙钟需先换算,月末/工作日表达式以文档支持的 cron 语法为准
  • 新增或修改触发器可能需数分钟(文档称最长约 15 分钟)才传播到全球网络
#Cloudflare Workers#Cron Triggers#scheduled#UTC#独立开发者