给 Workers 和 Durable Objects 设花费上限:预算护栏该放在架构哪一层
Cloudflare Spend Management 已进入 Beta,面向 PayGo 客户,先从 Workers 和 Durable Objects 开始,支持阈值告警和达到上限后暂停计费调用。按官方对计量管道的描述,这条护栏位于用量聚合与评级之后、通过运行时配置异步下发,因此它更接近账户级止损线,不能作为请求路径上的精确闸门。合理的分工是:应用层负责按租户和请求做同步准入,平台层负责账户与产品级的最终兜底,告警与审计负责在触发前留下判断依据。
- Spend Management 的上限是产品级、账户级的:配置项以 product_id 标识产品,材料未说明支持到单
- 执行是异步的:请求先产生用量,经两阶段聚合与 Rating Engine 计算后,才由策略服务把上限下发到运行时配置,因
- 达到上限后只暂停产生费用的客户代码调用;Workers 中 Cron Triggers 和 Queue consumer
- 账单周期从付费订阅开始计算,不是自然月,预算重置时间点需要按订阅周期核对。
简短回答:预算护栏不适合只放在一处。Cloudflare 的 Spend Management 解决了“账户被意外用爆”的问题,但它按官方描述是一套异步的计量与下发链路,不是请求路径上的同步阀门。合理的分层是:应用层做按租户、按用户的同步准入;平台层用 Spend Management 做账户与产品级的最终止损;中间再用告警和审计日志补上“触发之前”的判断依据。
平台护栏能设置哪些限制#
按 Cloudflare 博客的介绍,Spend Management 目前处于 Beta,面向所有按量付费(PayGo)客户,首批覆盖 Workers 和 Durable Objects,其他产品随后(来源:Cloudflare 博客,2026-11-13)。可设置的内容包括:为某个产品启用花费控制、填写一个通知邮箱、设定一个或多个告警阈值,以及一个会触发阻止策略的花费上限。达到阈值时发邮件,达到上限时产品被自动暂停。
几个容易被忽略的细节:
- 粒度是“账户 × 产品”。配置项里用
product_id(示例中为workers)标识受控产品。材料没有说明是否支持按单个 Worker 脚本、单个 Durable Object 命名空间或单个租户设上限,这类更细粒度待核实。 - 账单周期不是自然月。材料明确说明周期从付费订阅开始计算,10 月 10 日开始的订阅一般对应 10 月 10 日至 11 月 10 日。预算重置的时间点必须按订阅周期核对,不能按月初规划。
- 有审计轨迹。控制台提供审计日志,可查询谁在何时修改了限额、上限何时被触达;CLI 侧对应
audit list与activity list两个子命令。 - 暂停不等于不计费。材料描述的是拒绝该产品的新调用,已经产生的用量仍会进入账单。护栏的作用是封顶后续增长,不是把已发生的费用清零。
为什么它必然不是请求路径上的阀门#
这是本文的核心判断,依据是材料对内部链路的描述。一次计费事件的生命周期大致是:
- 两阶段聚合。每个调用产生用量度量(请求数、CPU 时间、执行时长或存储操作,取决于产品)。第一阶段在解析点附近把原始事件聚合成通常一分钟的桶;第二阶段再由另一个服务按相同分组规则合并成通常五分钟的桶,并归档。这样做的目的是在下游之前先把数据量降下来。
- Usage Engine。把聚合后的度量翻译成标准化的用量记录(账户、时间窗、指标、数量、维度),按账户分区处理,每个分区维护本地状态和磁盘上的预写日志(WAL),以便故障后重建。分区内同时持有用量与订阅信息,因此可以在本地应用包含额度。
- Rating Engine。把用量记录、订阅信息(账单周期、套餐变更)和定价规则(费率、包含额度、计费取整)三者合并,计算累计花费。用量流和订阅流是独立到达的,因此材料明确说明:如果用量先到而定价所需的订阅信息尚未到达,该用量会被保留为 pending,等信息补齐后再处理,而不是当作免费。
- 策略评估与上报。判断是否触及告警或阻止阈值,并更新仪表盘、发出邮件。
- 异步下发。材料明确写道,Rating Engine 不在请求路径上,也不直接拒绝请求;策略服务把上限发给运行时配置服务,由后者传播。抓取到的正文在此处截断(停在 “Quick” 之后),最后一跳的分发机制与传播延迟本次材料未提供。
由此可以推出一个对容量规划很重要的性质:从“真实花费越过上限”到“新调用被拒绝”之间存在一个窗口,它至少包含聚合窗口(分钟级)、评级处理、策略评估和配置传播。材料给出的“仪表盘近实时、10 分钟以内”是展示口径,不能直接当作阻断生效时延。因此这条护栏应当被理解为“止损线”而不是“精确闸门”:它能把一次事故的损失限制在“上限 + 一个窗口内的用量”,而不是保证花费绝不超过某个数字。这个窗口的具体长度待核实。
这也是架构上的取舍,不是缺陷。把限额判断放进请求路径意味着每次调用都要做一次跨区域的一致性检查,代价和单点风险都很高;放到计量侧则可以先聚合再决策,扩展到全平台。代价就是最终一致。
三层护栏的分工#
下面是按上述性质给出的分工建议,属于设计意见,不是 Cloudflare 的官方推荐:
| 层 | 位置 | 判断时延 | 适合的粒度 | 主要局限 |
|---|---|---|---|---|
| 业务准入层 | 应用代码、API 网关前置逻辑 | 同步,毫秒级 | 租户、用户、单次请求、令牌桶 | 只能拦住经过自己的路径;要自己维护计数存储 |
| 平台计量层(Spend Management) | 聚合与评级之后,经运行时配置下发 | 异步,分钟级(具体待核实) | 账户 × 产品 | 有超支窗口;暂停是产品级,可能影响无关业务 |
| 告警与审计层 | 阈值通知、审计日志 | 分钟级 | 账户 × 产品 | 只通知不阻断,依赖有人接收 |
| 恢复与演练层 | Runbook、值班流程 | 人工 | — | 恢复期间业务处于降级态,积压会在恢复后反弹 |
对 AI 推理类负载,材料提到 AI Gateway 已支持按用户和按模型的预算,作用于经过网关的请求。这与 Workers 的产品级上限是互补关系:网关侧更靠近请求,粒度更细;Spend Management 更靠后,覆盖面更广。具体两者的计费口径如何叠加,材料未展开,待核实。
配置动作与恢复路径#
材料给出了控制台、cf CLI 和 REST API 三种配置方式。以下代码照录自材料,本次未执行,仅用于说明字段结构;邮箱为材料中的占位示例:
curl --fail-with-body --request POST \
"https://api.cloudflare.com/client/v4/accounts/${CLOUDFLARE_ACCOUNT_ID}/billing/spend-policies" \
--header "Authorization: Bearer ${CLOUDFLARE_API_TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"name": "Workers spending cap",
"product_id": "workers",
"enabled": true,
"threshold_cents": 10000,
"action": "usage_block",
"notification_email": "me@example.com"
}'
threshold_cents 从字段名看以“分”为单位,10000 对应 100 个计价货币单位;具体币种与最小计价单位材料未说明,待核实。CLI 侧的可用子命令包括 list、create、get、update、delete、audit list、activity list。
触发之后的恢复路径有三条:把上限提高到当前周期累计花费之上;禁用或删除阻止策略;等下一个账单周期,已有的阻断自动失效。
建议把这三条写进 runbook,并额外考虑两件材料没有涉及、但由暂停语义可以直接推出的运维问题:
- 半可用状态。Workers 场景下 Cron Triggers 和 Queue consumer 被暂停而静态资产继续提供,意味着前端可能正常、异步任务全停。监控需要能区分“HTTP 正常”和“队列在积压”。
- 恢复后的反弹。队列消息在暂停期间持续累积,撤销阻断后消费者会面对一段积压高峰,可能再次推高用量。恢复动作最好与限流或分批消费一起执行。Durable Objects 暂停后其内部状态如何处理,材料未说明,待核实。
边界与待核实项#
本文结论的范围限于材料所描述的内容。以下几项在决策前需要向官方文档或实际控制台确认,不应从本文推断:
- 是否支持按脚本、按命名空间或按租户的更细粒度上限;
- 阻断生效的实际传播延迟,以及它与“10 分钟内”这一展示口径的差距;
threshold_cents的币种与取整规则;- Durable Objects 被暂停时,存储操作、活动实例与状态的具体行为;
- Spend Management 与 AI Gateway 预算同时命中时的先后关系;
- Beta 阶段的功能范围与价格条款是否变化。
回到标题的问题:预算护栏应当放在架构的每一层,但每层承担不同职责。同步的、细粒度的判断放在你能控制请求的那一层;账户级的、覆盖面最大的兜底交给平台计量层,并接受它存在分钟级的超支窗口;两者之间用阈值告警和审计日志接上,让“是否要人工介入”成为一个有依据的判断,而不是事后追账。
常见问题(FAQ)
达到上限后整个 Worker 会完全不可用吗?
提高上限后为什么花费没有立刻恢复?
参考来源
以上为本文写作时的参考资料,引用观点以原文为准。