背景
我有一个跑在 Cloudflare Workers + D1 上的阅读站,内容需要登录才能看。最近反馈是「打开很慢、翻页很慢」。
第一反应是缓存没配好。查完发现:缓存是好的,慢在两个完全不相关的地方。 一个在我自己的网络链路上,一个在服务端每次翻页的查询数量上。
这篇记录怎么拆开看,以及同一天在这个项目上踩的另外两个坑:CI 等太久、Workers Builds 找不到部署脚本。
第一步:确认缓存到底有没有生效
先看响应头,别猜:
- 静态资源
/assets/*:cf-cache-status: HIT,Cache-Control是 immutable 长缓存。没问题。 - HTML 页面和服务端函数:
no-store。这是故意的,内容需要登录,不能进公共缓存,否则可能把一个用户的页面缓存给另一个人。
所以「加缓存」这条路走不通,也不该走。登录内容的 HTML 不能靠 CDN 缓存提速。
第二步:把 TTFB 拆开
Cloudflare 的响应头 Server-Timing 里有 cfWorker(Worker 执行时间)和 cfEdge(边缘处理时间)。拿它们和浏览器测到的 TTFB 对比:
| 请求 | 浏览器测到的 TTFB | Worker 执行 | 差额 |
|---|---|---|---|
| 登录页 | 219 ms | 5 ms | 很小 |
| 登录后的阅读首屏 | 7.7 s | 857 ms | 约 6.2 s 不在服务端 |
| 已缓存的 CSS | 0.6~4.7 s | 不经过 Worker | 全在链路上 |
最后一行最能说明问题:一个已经命中边缘缓存的 CSS 文件,TTFB 都能到 4.7 秒,期间还出现过 TLS 握手失败。这跟服务端代码没有任何关系。
原因是我本机走了代理,出口在日本,而这次连上的 Cloudflare 边缘节点在台北。大部分时间耗在本地代理排队和建连上。
结论一:先分清「服务端慢」和「我的网络慢」。 拿 Worker 执行时间和 TTFB 对比,差额大,就别急着改代码,先换网络、关代理再测一遍。
第三步:服务端那 857 毫秒和慢翻页
链路问题解释了首屏的大头,但翻页单独测也要 1.8~4.6 秒,Worker 执行也不算快。
查下来,每次翻页要发大约 30 批 D1 查询。翻一页,服务端会重新算整章的数据包、上下文哈希、标签历史,然后再加载审阅记录和评论。读者只想看下一页,服务端却把编辑后台要的东西也算了一遍。
修法是给阅读页单独做一个精简的读模型:
- 阅读页只取正文和翻页需要的数据;
- 审阅历史挪到单独的页面,需要时再打开;
- 能合并的查询合并成一批。
结果:每页 D1 批次从约 30 降到 4。 Web 测试 44/44 通过,阅读相关测试 10/10 通过,CI 通过后合并。
需要说明:合并时还没部署,所以这里没有上线后的翻页耗时数据,我不编一个数字出来。按查询批次算,服务端这部分应该明显下降,但链路那 6 秒不会因此消失。
结论二:D1 每次查询都有往返成本,查询批次数比单条 SQL 写得多漂亮更重要。 先数一次请求发了几批,再谈优化。
同一天的坑一:CI 要等 22 分钟
合并要过一个 Linux 检查,单个检查大约 22 分钟。
先确认它能不能删:分支保护规则要求这个检查通过才能合并,而部署走的是 Workers Builds,在 main 上独立触发。所以这个检查是合并保护,不是部署前提,不能删,只能拆。
拆法:
- 静态检查单独一个任务;
- 测试拆成 4 个分片,按历史耗时平衡分配,比如第 1 片是 66 个测试、205.71 秒;
- 部署冒烟单独一个任务:dry-run、构建验证、Worker 冒烟测试;
- 最后用一个汇总任务沿用原来的检查名。这样分支保护规则不用改,汇总任务在所有分片都过了才算通过。
预计等待时间从约 22 分钟降到 7~9 分钟。这是按分片耗时估出来的,不是实测值。代价是总 runner 分钟数会变多,并行要花钱。
沿用旧检查名这一点很关键。改了名字,分支保护就会一直等一个不会再出现的检查,所有 PR 都合不进去。
同一天的坑二:Script not found "deploy"
Workers Builds 部署报错:
Script not found "deploy"
原因:项目是 monorepo 结构,deploy 脚本写在子目录的 package.json 里,而 Workers Builds 默认在仓库根目录执行命令。
两种修法,任选一种:
- 在 Workers Builds 设置里把 Root directory 改成那个子目录;
- 或者把部署命令改成
bun --cwd <子目录> run deploy。
顺手确认了几件事:
- 这个
deploy脚本的顺序是 D1 迁移 → 构建 →wrangler deploy,用&&串起来,迁移失败就不会继续部署。这个顺序是对的,别为了快把迁移挪到后面。 wrangler deploy --dry-run不会执行 D1 迁移,所以 dry-run 通过不代表迁移没问题。- 构建用的 API token 至少要有 D1 编辑和 Workers Scripts 编辑两项权限,少一个就会在迁移或部署那一步失败。
清单
遇到「Workers 站点慢」,我现在按这个顺序查:
- 静态资源是不是
HIT?不是,先修缓存。 - HTML 该不该缓存?登录内容不该缓存,别硬加。
- TTFB 减去
cfWorker,差额大不大?大,先换网络、关代理重测。 - 一次请求发了几批 D1 查询?两位数就要拆读模型。
- 读者页面有没有顺带算后台才需要的数据?有就挪走。
口径:所有耗时来自 2026-11-03 至 11-04 我在本机代理环境下的实测和 Codex 排查记录,换网络结果会不同;CI 提速是估算值;站点、仓库和账号信息已泛化。
COMMENTS
读者评论