D1 Database Limits 2026:最先被击穿的真实上限

D1 database limits 2026 详解:免费版单库上限 500 MB、付费版 10 GB,Free 每日 500 万行读与 10 万行写,单条 SQL 查询最长 30 秒,单线程写入吞吐随查询变慢下降,Time Travel 恢复窗口 7/30 天,在把 schema 定下来之前先看这些上限。

Huifer
Huifer
November 19, 202610 min read
其他语言:Deutsch · English

本文由 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 FreeWorkers Paid
每账户数据库数10限制页列出 50,000;定价页另述包含 100,000 个*
单库最大容量500 MB10 GB
每账户最大存储5 GB1 TB
单次 Worker 调用查询数501,000
Time Travel 恢复窗口7 天30 天
Time Travel 恢复操作每数据库每 10 分钟 10 次每数据库每 10 分钟 10 次
每表最大列数100100
行/字符串/BLOB 最大尺寸2 MB2 MB
SQL 语句最大长度100 KB100 KB
每条查询最大绑定参数数100100
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」(过载)错误。

sql
-- 悄悄吃掉容量的那种查询形状。
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() 让每次请求的开销只付一次。

typescript
// 检查每条语句的扫描量;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 数据库限制不是冷知识;它们决定了起步模板的数据模型能否挺过你的第一次增长事件。购买之前,先问四个问题:

  1. 默认 schema 存了什么? 请求日志、完整负载和无上限的审计表,是消耗 500 MB(Free)或 10 GB(Paid)上限最快的部分。
  2. 热点路由有索引吗? 如果起步模板的查询既没有索引也没有扫描量插桩,它就把每日读取成本和并发成本藏起来了。
  3. 写入是什么形态? 每个请求都同步写入的 checkout 或用量事件,需要批处理、队列,或一个明确的低流量边界。
  4. 恢复故事是什么? 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 链接文档的内容,可能会有变化。