用途:Cloudflare Workflows 是 Cloudflare Workers 上的持久执行框架,用于构建多步骤应用。每个工作流需继承 WorkflowEntrypoint 并实现 run() 方法,通过事件负载传入参数,步骤执行结果必须可 JSON 序列化。
主要能力:step.do() 执行可重试的工作,可配置 retries.limit、delay 与 backoff(constant/linear/exponential)以及 timeout;step.sleep() 相对休眠,支持秒到年单位或毫秒数;step.sleepUntil() 休眠至指定时间;step.waitForEvent() 等待外部事件,默认超时 24 小时。错误处理支持 NonRetryableError 立即失败,也可 try/catch 捕获步骤错误让工作流继续。
用法:可用命令 npm create cloudflare@latest my-workflow -- --template cloudflare/workflows-starter --git --deploy false 创建模板;在 wrangler.jsonc 的 workflows 中配置 name、binding、class_name;npm run deploy 部署后用 npx wrangler workflows instances list my-workflow 查看实例、用 npx wrangler workflows instances describe my-workflow <instance-id> 检查状态。Worker 中通过 env.MY_WORKFLOW.create() 创建实例、get() 获取实例、sendEvent() 发送事件,并支持 pause、resume、terminate。
适用场景:长时流程、视频处理、支付确认、定时任务、跨服务编排等需要重试与休眠的场景。
限制:资料仅描述框架用法,未提供收费、价格、平台配额或性能数据;返回值为不可序列化类型时会抛出错误。