技术文章

外部链接将在新标签页打开。

消费上限怎么设计:从 Workers 与 Durable Objects 的计费口径到异步阻断边界

一句话回答

Cloudflare 2026 年 11 月 13 日的公告显示,Spend Management 先统一计量与计价口径(账期从订阅开始、累计用量先扣包含额度、未定价用量保留为 pending),再按告警阈值与消费上限分层执行;阻断只暂停产生成本的客户代码调用,且执行是异步的,因此从触达上限到全网拒绝之间存在时间窗。超调量材料未给出,需要自行验证。

核心要点 TL;DR
  • 账期从付费订阅开始,不是自然月;dashboard 上的周期成本不能直接当成本月账单。
  • 阻断作用在计费路径上:Workers 中 Cron Triggers 与 Queue consumer 会暂停,静态资源
  • 上限执行是异步的,Rating Engine 不在请求路径上,所以需要为生效延迟留出余量;延迟与超调数据本次材料未提供。

设计消费上限,难点主要在于先把“这个数字怎么算出来”定清楚,而不是先决定设成多少。Cloudflare 在 2026 年 11 月 13 日的公告中把 Spend Management 描述为一条从计量聚合、计价到策略评估与阻断的链路(Cloudflare Blog)。对开发者来说,可复用的经验是四个口径:账期、额度扣减顺序、舍入方式、未定价用量怎么处理。口径定完,再谈阈值分层和阻断粒度。

一、计费口径:账期、扣减顺序与未定价用量#

公告特意提醒:计费周期从付费订阅开始时算起,而不是从部署 Worker 或创建消费上限时算起。订阅若在 10 月 10 日开始,周期通常是 10 月 10 日到 11 月 10 日,并非自然月。这意味着 dashboard 上的“当前周期成本”与财务口中的“本月账单”可能不是同一个区间,做预算规则时要按账期对齐。

计价对象是累计用量,并非单个请求。公告的说明是:Rating Engine 先把账号的包含额度套用到累计用量上,再对超出部分计价;一百万 CPU 毫秒不必然产生额外费用;它对累计用量计价,而不是对每个请求分别舍入并收费。自建计量时,这个顺序直接决定“先扣额度还是先算钱”,也决定小额高频请求会不会因为逐次舍入而虚高。

还有一个容易被忽略的边界:用量数据和订阅信息是两条独立的数据流,可能乱序到达。公告称,如果计价所需的订阅信息尚未到达(例如 webhook 失败),系统会把用量保留为 pending,等信息补齐后再处理,而不是把未定价用量当作免费。这是保守处理,值得在自建系统里照搬。

二、告警阈值和消费上限是两层,不要混用#

按公告,启用某个产品的消费控制时,可以设置一个消费上限、一个通知邮箱,以及一个或多个告警阈值。评估消费触达任一阈值时发邮件;触达上限时执行阻断策略,产品被自动暂停。公告的 dashboard 示例里,Workers 在触达硬上限之前触发了两次告警。

层级触发条件行为
告警阈值评估消费达到任一设定阈值向配置的邮箱发送通知
消费上限评估消费达到上限执行阻断策略,产品自动暂停
审计日志限额被修改或上限被触达记录谁在何时修改、何时触达

观察延迟也要计入设计。公告称 dashboard 显示的当前周期成本是近实时的,给出的量级是 10 分钟以内。也就是说,告警更接近分钟级观察,不应被当作秒级熔断来使用。

三、阻断粒度:只暂停会产生成本的调用#

公告明确:上限生效后,该产品的新调用会被拒绝,但只暂停会产生成本的客户代码调用。以 Workers 为例,Cron Triggers 和 Queue consumer 调用会暂停,静态资源继续提供。这个边界很重要:上限控制的是计费路径,并未把整个产品面全部关掉。

恢复服务有三条路径,公告均已列出:

  • 把上限提高到当前周期累计消费之上;
  • 禁用或删除阻断策略;
  • 等到下一个计费周期,既有阻断自动过期。

建议把这三条写成值班手册(runbook),并明确谁有权改上限。公告提到审计日志能看到谁在何时改了限额、何时触达上限,这为变更追责提供了依据;但“谁有权改”属于组织流程,公告并未规定。

四、异步生效,所以必须接受超调#

公告说明 Rating Engine 不位于请求路径中,也不直接拒绝请求;策略服务把上限下发给运行时配置服务。本次抓取到的正文在这里被截断,后续下发细节无法据此展开。

由此可推断:从“累计消费触达上限”到“全网新调用被拒绝”之间存在非零时间窗,窗口内仍可能产生计费调用,也就是超调。超调幅度与当时的消费速率、两级聚合窗口(公告称一级通常为 1 分钟、二级通常为 5 分钟)以及下发延迟有关。本次材料没有给出端到端生效延迟或超调数据,需要按自己的流量特征实测。

据此给一条设计建议:不要把硬上限贴着预算红线设置。可以按“峰值消费速率 × 预期生效延迟”估算缓冲,再按业务能承受的超调反推上限值;如果业务对超调零容忍,就需要在应用侧再加一层同步配额,而不能只依赖账户级上限。

五、用 API 或 CLI 配置:一个未执行的示例#

公告称可以通过 dashboard、cf CLI 或 REST API 配置。下面的请求来自公告示例,本次未执行;账号 ID、API Token 与通知邮箱都需要替换,邮箱使用示例域名。不要把真实 Token 写进代码库。

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 个货币单位;但本次材料未说明币种与限额范围,待核实。action 的示例取值为 usage_block,product_id 的示例取值为 workers。公告还列出了 CLI 的对应子命令:cf billing spend-policies list/create/get/update/delete,以及 audit list 和 activity list。

六、与 AI 预算分层组合,以及落地前要核实的项#

公告提到,AI Gateway 已经支持按用户、按模型的预算,作用于经网关路由的 Workers AI 及其他 AI 提供商的请求。两者组合形成两层:账户级上限约束总量,网关级预算约束单个用户或单个模型。公告同时说明,Spend Management 目前是 Beta,面向按量付费(PayGo)客户,先从 Workers 和 Durable Objects 开始,其他产品“很快”支持,但未给日期。

上线前建议逐项核实:Beta 阶段的实际限制;币种、最小与最大限额、阈值数量上限;端到端生效延迟与真实超调量;以及阻断期间静态资源之外的依赖服务(例如通过 Service Binding 调用的下游)是否会计费。这些项目在本次材料中要么未提供,要么只给了定性描述。

可复用的结论与具体的 API 字段关系不大;真正的顺序是:先统一账期与计价口径,再分层设置告警与阻断,再选定阻断粒度与恢复路径,最后为异步生效留出超调余量。

常见问题(FAQ)

上限触发后 Worker 会完全不可用吗?
按公告,只暂停会产生成本的客户代码调用。Workers 中 Cron Triggers 和 Queue consumer 调用暂停,静态资源继续提供。
计费周期是自然月吗?
不是。公告举例:10 月 10 日开始订阅,周期通常是 10 月 10 日至 11 月 10 日,而不是按日历月切分。

参考来源

  1. Introducing Spend Management: Spending limits and alerts for Cloudflare

以上为本文写作时的参考资料,引用观点以原文为准。

作者:沐小悠

本文约 8 分钟读完 · 关键词:Spend Management、Workers、Durable Objects、消费上限、计费口径

更多文章 GET 示例接口

「」标签下的其他文章