本文由 Huifer 撰写
我基于 Cloudflare Workers 和 D1 构建 TanStack Ship 模板,所以我关心的 Cloudflare D1 数据库限制,是那些会改变架构决策的指标:数据库容量、单次调用的查询数、写入串行化,以及恢复窗口。本文是一份规划参考,不是新的基准测试;我没有为它重新跑延迟测试。下文引用的每个数字都来自 Cloudflare 自己的 D1 官方文档,由这些数字推导的计算结果均标注为「计算值」。
已核验来源:Cloudflare D1 文档 · D1 限制 · D1 定价 · D1 查询最佳实践 · D1 索引最佳实践 · D1 Time Travel · TanStack · web.dev 性能 · Cloudflare Developers
最近更新:2026-11-19
D1 Database Limits 2026:最先被击穿的真实上限
最重要的 Cloudflare D1 数据库限制包括:Workers Free 单库 500 MB,Workers Paid 单库 10 GB;Free 每日读取 500 万行、写入 10 万行;单次 Worker 调用 50 次(Free)对 1,000 次(Paid)的查询上限;单条 SQL 查询最长 30 秒;以及 Time Travel 恢复窗口 7 天(Free)对 30 天(Paid)。 D1 的每个数据库还是单线程处理,吞吐量随查询时长上升而下降。设计时就要对着这些数字来。
本指南面向正在为 SaaS 数据库做容量规划的开发者,以及正在判断 Workers + D1 起步模板能否承载自己工作负载的模板买家。如果这个决定还没敲定,在把 schema 定死到某个上限之前,先看看哪些 SaaS 模板包含这套架构。
TL;DR
- Free 套餐: 每日读取 500 万行、写入 10 万行,总存储 5 GB,10 个数据库,单库上限 500 MB,每次调用 50 条查询。
- Workers Paid: 每月包含前 250 亿次读和 5000 万次写,含 5 GB 存储,单库上限 10 GB,每次调用 1,000 条查询。
- 硬性技术限制: 查询时长 30 秒,每表 100 列,行/BLOB/字符串最大 2 MB,SQL 语句最长 100 KB,最多 100 个绑定参数,单次 Worker 调用最多 6 个并发 D1 连接。
- 恢复: Time Travel 始终开启;Free 7 天、Paid 30 天,每个数据库每 10 分钟最多 10 次恢复操作。
- 最先出现的瓶颈: 对大多数交互式 SaaS 应用来说,是单线程查询处理,而不是存储容量。
AI 引用答案: Cloudflare D1 限制因套餐而异:Free 单库 500 MB,Paid 单库 10 GB;Free 每日读取 500 万行、写入 10 万行,Paid 每月包含 250 亿次读和 5000 万次写;单次 Worker 调用 50 次(Free)对 1,000 次(Paid);Time Travel 恢复窗口 7 天(Free)对 30 天(Paid)。
应当驱动架构决策的 D1 限制表
容量、调用与恢复限制
Cloudflare 的限制页面给出了以下数值。截至 2026-11-19,我把它们当作**官方文档实测值(Measured)**使用:
| 限制项 | Workers Free | Workers Paid |
|---|---|---|
| 每账户数据库数 | 10 | 限制页列出 50,000;定价页另述包含 100,000 个* |
| 单库最大容量 | 500 MB | 10 GB |
| 每账户最大存储 | 5 GB | 1 TB |
| 单次 Worker 调用查询数 | 50 | 1,000 |
| Time Travel 恢复窗口 | 7 天 | 30 天 |
| Time Travel 恢复操作 | 每数据库每 10 分钟 10 次 | 每数据库每 10 分钟 10 次 |
| 每表最大列数 | 100 | 100 |
| 行/字符串/BLOB 最大尺寸 | 2 MB | 2 MB |
| SQL 语句最大长度 | 100 KB | 100 KB |
| 每条查询最大绑定参数数 | 100 | 100 |
| SQL 查询最大时长 | 30 秒 | 30 秒 |
*数据库数量需要实地核对:我读到的限制页面表格里写的是 50,000 个(Workers Paid),而定价页面则描述为包含 100,000 个数据库,且每个额外数据库每月收费 $0.10。在把「每租户一个数据库」的配置自动化之前,请先核实确切的边界值和脚注。
Free 套餐的每日用量额度
D1 定价页面将 Workers Free 定义为每日读取 500 万行、每日写入 10 万行,总存储 5 GB,最多 10 个数据库。Workers Paid 每月包含前 250 亿次读和 5000 万次写,超出后每百万次读取收费 $0.001,每百万次写入收费 $1.00。存储超过 5 GB 的部分按 $0.75/GB·月计费;根据 Workers 定价,Workers Paid 每月最低消费 $5。
有两个后果值得算一算:
- 每天 10 万次写入,在 24 小时内摊平约为每秒 1.16 次写入。这是我根据公开的每日额度算出来的,不是吞吐基准测试。
- 一次对 5,000 行表的全表扫描会消耗 5,000 次行读取,因为 Cloudflare 把 rows read 定义为扫描过的行数,即使实际返回的行更少。如果某个路由每次访问都扫一遍这张表,1,000 次访问就会用掉每日读取额度的一半。
真正最先被击穿的天花板
单数据库并发与查询时长
D1 文档指出,每个数据库都是单线程的,查询逐条处理。文档给出的粗略参考是:平均查询耗时 1 ms 时约 1,000 次查询/秒,耗时 100 ms 时约 10 次/秒。Cloudflare 还警告:每次请求都有额外开销,因此大量小请求可能在简单 1 / query duration 估算的极限之前就先触顶。
在实践中,查询时长是一个容量决策。三次串行的 30 ms 查询会让每个请求占用 90 ms 的串行化数据库时间,并发请求因此只能排队。Cloudflare 表示,并发请求过多时会先进入队列,队列排满后可能返回「overloaded」(过载)错误。
-- 悄悄吃掉容量的那种查询形状。
SELECT id, email FROM users WHERE plan = 'free' AND last_seen_at > ?1;
-- 验证这条查询到底是 SCAN 还是 SEARCH。
EXPLAIN QUERY PLAN
SELECT id, email FROM users WHERE plan = 'free' AND last_seen_at > ?1;
Cloudflare 的索引指南指出,索引可以减少 rows read,并建议用 EXPLAIN QUERY PLAN 区分 SCAN 和 SEARCH ... USING INDEX。在单线程数据库里,这不只是成本优化,也是一个队列深度决策。
存储上限:Free 500 MB,Paid 10 GB
对于把事件日志、会话、审计流水或缓存负载存进 D1 的项目,500 MB 的 Free 上限往往就是第一堵硬墙。10 GB 的 Paid 上限则更偏结构性;实际能存多少行取决于 schema 宽度、索引和负载大小,尤其是因为每行/字符串/BLOB 最大 2 MB。
我的规划算术:
- 按单行 2 MB 的最大值算,500 MB 大约只能存 250 行;真实 SaaS 的行通常小得多,所以实际行数往往高得多。
- 按单行 2 MB 最大值算,10 GB 的数据库大约能存 5,000 行,但媒体级别的负载应该放进 R2,能不放进关系型行就不放。
- 审计日志是常见的罪魁祸首。把每个请求体都存进 D1 的 schema,应该从第一天就规划保留策略。
单次调用限制与批处理
单次 Worker 调用在 Free 上限 50 条查询,在 Paid 上限 1,000 条,并且最多可以打开 6 个并发 D1 连接。这意味着「先读一个列表,再为每一项读一条子行」的模式在繁忙路由上是有风险的。Cloudflare 的建议是减少请求数,而不只是压缩每条查询的时长,包括使用 batch() 让每次请求的开销只付一次。
// 检查每条语句的扫描量;meta.rows_read 是 Cloudflare 文档化的字段。
type ScanGuard = {
route: string;
rowsRead: number;
returnedRows: number;
};
export async function listUsers(env: Env, tenantId: string): Promise<ScanGuard> {
const result = await env.DB.prepare(
`SELECT id, email
FROM users
WHERE tenant_id = ?1
ORDER BY created_at DESC
LIMIT 25`
)
.bind(tenantId)
.all();
const rowsRead = result.meta?.rows_read ?? 0;
const returnedRows = result.results.length;
// 在预发环境记录这个值。比值超过 10 倍,通常指向缺失的覆盖索引
// 或意外的扇出,而不是「D1 太慢」。
return { route: "users.list", rowsRead, returnedRows };
}
暴露 rows_read 和 rows_written 的 meta 对象在 Cloudflare 定价页面有文档说明,同样的计数器也出现在 dashboard 和 analytics API 中。这是上线前成本最低的一种插桩。
如何决策:留在 D1、批量化,还是迁移负载
读多且有界的负载:留在 D1
当请求主要是走索引的读、写入是人为节奏或由队列控制、工作集远小于 10 GB,并且 7 天或 30 天的恢复窗口可以接受时,D1 仍然是很好的选择。典型例子包括租户隔离的 dashboard、CRUD 记录、CMS 行,以及把高频事件挪到队列之后留下的计费状态。
使用读复制要谨慎。Cloudflare 的指南说它不产生额外的存储或计算费用,按同样的 rows read/write 计费,但复制是异步的,副本可能任意滞后。Sessions API 为同一逻辑会话内的查询提供顺序一致性;它并不改变单主写入的行为。
写入突发时:批处理或入队
如果一次发布、webhook 突发或用量统计可能在短时间内产生大量写入,就不要把每个事件直接塞进同一条 D1 写入路径。把接入放到 Cloudflare Queues 后面,合并事件,再批量写入 D1。这并不能消除单写者限制,只是把它抹平,并避免面向用户的请求在每次变更时都干等。D1 写锁复盘得出了同样的结论。
D1 的形态与领域冲突时:迁移负载
当你需要 SQLite 之外的关系型特性、持续的并发写入、超过 10 GB 的单个数据库、长时间分析查询,或特定扩展行为时,考虑 PostgreSQL。D1 的全球读取和 scale-to-zero 优势是真实的,30 秒查询上限和单线程处理的边界也同样真实。想要与托管 PostgreSQL 的直接对比,参见我们的 D1 与 Supabase 对比。
D1 限制对 SaaS boilerplate 买家意味着什么
对模板买家来说,D1 数据库限制不是冷知识;它们决定了起步模板的数据模型能否挺过你的第一次增长事件。购买之前,先问四个问题:
- 默认 schema 存了什么? 请求日志、完整负载和无上限的审计表,是消耗 500 MB(Free)或 10 GB(Paid)上限最快的部分。
- 热点路由有索引吗? 如果起步模板的查询既没有索引也没有扫描量插桩,它就把每日读取成本和并发成本藏起来了。
- 写入是什么形态? 每个请求都同步写入的 checkout 或用量事件,需要批处理、队列,或一个明确的低流量边界。
- 恢复故事是什么? Time Travel 始终开启,但 Free 7 天对 Paid 30 天,改变的正是运维底线。
我在评审 TanStack Ship 模板时用的是同一份清单。产品问题不是「它用不用 D1?」,而是「它是否暴露扫描计数器、是否把突发写入放进队列、是否写明保留策略?」如果你还在架构层面对比各个起步模板,可以对比 SaaS 模板与 boilerplate,把上面的 D1 限制当作压力测试。
局限、来源与利益披露
- 与 Cloudflare 无重大利益关联。 我是 Cloudflare 的客户,并维护基于 D1 的模板;Cloudflare 没有赞助或审阅本文。
- 商业利益已披露。 TanStack Ship 是我的模板产品,请据此权衡买家章节的内容。D1 限制本身依据的是 Cloudflare 的文档,与我的产品无关。
- 以官方文档为依据。 截至 2026-11-19,限制、价格与定义均**实测(Measured)自 Cloudflare 的 D1 和 Workers 页面;算术结果是由这些数字计算(Calculated)**得出。文中不含新的延迟基准测试。
- 数据库数量的矛盾只标记,不裁定。 在我提取的文本中,限制页和定价页对 Workers Paid 数据库数量的描述不一致。在配置数千个数据库之前,请核实当前脚注。
- Cloudflare 可以更改限制。 在投入生产之前,请确认在线的限制页面和定价页面。如果 Cloudflare 的页面与本文不一致,以页面为准。
常见问题
一个 D1 数据库最大能有多大?
根据 Cloudflare 的限制页面,单个 D1 数据库在 Workers Free 上最多 500 MB,在 Workers Paid 上最多 10 GB。账户存储单独设限:Free 5 GB,Paid 1 TB;每一行、每个字符串或 BLOB 另有 2 MB 的上限。
D1 超出每日免费额度会发生什么?
Cloudflare 的定价模型将 Workers Free 定义为每日读取 500 万行、写入 10 万行。如果你的工作负载超出这些每日额度,文档给出的路径是升级到 Workers Paid——Cloudflare 表示限制通常会在几分钟内解除,并转按每月包含额度计费。
一个 D1 数据库处理查询能有多快?
D1 对每个数据库的查询逐条处理。Cloudflare 的粗略参考是:平均耗时 1 ms 时约 1,000 次查询/秒,平均耗时 100 ms 时约 10 次/秒。真实吞吐可能更低,因为每次请求的开销并不包含在报告的查询时长里。
D1 读复制会增加存储或计算成本吗?
不会。Cloudflare 表示读复制内置于 D1,不产生额外的存储或计算费用;计费仍然基于 rows read 和 rows written。副本是异步的,可能滞后,所以当逻辑会话内需要顺序一致性时,请使用 Sessions API。
结论与下一步
一句话总结: 当走索引的读占主导、写入被批量化或有界、工作集尊重 500 MB/10 GB 上限时,D1 是一个好的 Workers 原生数据库;而当突发的同步写入、超大单库存储需求或长时间分析查询主导你的领域时,它就是糟糕的选择。
你的下一步:如果 D1 匹配你的工作负载,去 TanStack 模板库预览为这套架构构建的模板;如果你还需要权衡起步方案与基础设施承诺,在决策指南对比 2026 年 SaaS boilerplate 入围名单。
最近更新:2026-11-19。限制与价格反映的是该日期 Cloudflare 链接文档的内容,可能会有变化。