首屏永远 MISS:CDN、Set-Cookie 与跨区 SSR
okayok.ai 首屏慢的排查:不可缓存的 HTML、sin1→iad1 的 SSR、Set-Cookie 打穿缓存,以及随后的 geo×CDN 冲突;Shipokay 多站脚手架如何把同一类坑复制出去。
用户打开 okayok.ai 时,要的不是后台,而是品牌页尽快出现。首屏一粘,整个产品家族都会显得慢——哪怕图、字体和文案其实没大问题。
这是那次「粘」的工程故事:我们量到了什么、改了什么,以及接下来踩进的坑。
表象
用户侧感觉是「首页要等一下」。网络面板里更清楚。
诊断阶段(不是正式的上线前后对比实验)大致看到:
- HTML 冷启动 TTFB 可到数秒(有一次冷样本约 ~4.9s);紧接着再请求仍约 ~2.6s
- 文档响应几乎每次都是
X-Vercel-Cache: MISS - HTML 上是
Cache-Control: max-age=0——浏览器要再验证,边缘也留不下有用的副本 - 该次会话里浏览器 FCP 大约 ~2.7s
主 JS、字体也不轻(主包量级到数百 KB),但它们是次要矛盾。真正卡在文档本身。
真因
三件事叠在一起。
1. 营销 HTML 从未住在边缘
每次访问都 SSR 首页可以接受——前提是渲染便宜、数据在近处。我们两边都不成立。响应实质上不可缓存,于是每位新访客都再付一次 origin SSR。「永远 MISS」多半不是 CDN 坏了,而是响应头和副作用导致的。
2. SSR 里的跨区依赖
站点落在 Vercel sin1(新加坡),关键 API 在 iad1(美东)。根 loader 在文档路径上拉产品族和分析配置。亚洲访客等于在等新加坡再打一枪美国,HTML 才能拼完。
本地 vite dev 几乎看不出这件事,只有生产区域真实时才会露馅。
3. 文档响应上的 Set-Cookie
把归因(utm_*)和 geo/会话 cookie 写在 HTML 响应上很省事。省事,但对共享缓存是致命的:文档一旦被 Set-Cookie 个性化,中间层会当私有响应处理。你可以写得很漂亮的 s-maxage,照样永远 HIT 不了。
修复方向
改动故意偏「无聊」:
- 构建期 family 快照——构建时把产品/页脚图写入仓库,营销壳层 SSR 不必再跨太平洋。
- 营销 HTML 短边缘缓存——类似
public, max-age=0, s-maxage=300, stale-while-revalidate=86400(并配齐 CDN 缓存头);登录/应用/管理仍private, no-store。 - utm / geo 离开文档响应——改由客户端或专用接口写 cookie,让 HTML 可以共享。
同一套改法推到了 Okayok 家族各站——包括 Shipokay / ShipAny 的 TanStack 脚手架——因为复制能用的营销栈,也会复制它的缓存 bug。
这里不编造未验证的上线前后耗时对比。上文量级来自诊断窗口;部署后应用响应头核对 HIT(Age、X-Vercel-Cache、首页是否还在乱 Set-Cookie)。
转折:geo × CDN
缓存修好了慢路径,却弄坏了一条正确性路径。
按地区跳语言写在 origin 上的服务端包装(withGeo)里。边缘开始 HIT HTML 之后,这段逻辑根本不会跑。本该进 /zh 的访客可能拿到缓存的英文页。客户端只补 cookie,不等于做 locale 跳转。
这是 code review 里的 High:边缘缓存和「只在 origin 生效的重定向」天生合不来。
更稳的做法是:把「路径 + 国家 + Accept-Language → 语言」收成一份纯函数;请求打到 origin 时服务端跑一遍,文档来自缓存时浏览器跑同一套。营销 HTML 继续公开缓存;geo 不该靠每次响应塞 cookie 来否决 CDN。
Takeaway
- 首屏问题常常是文档问题,不是大图问题。
MISS配max-age=0是线索;HTML 上的Set-Cookie几乎是招供。- 跨区 SSR 在本地隐形,在真实 region 上现形。
- 多站脚手架(含 Shipokay)会放大修复,也会放大 bug——缓存策略应是共享基建,而不是某个站的一次性补丁。
- 一旦真的 CDN HIT,重新验证所有 origin middleware 假设(geo、鉴权门、A/B)。HIT 意味着那些假设已经不在场。
慢首页很少只有一个反派。我们的是:不可缓存的 HTML、过重的 SSR 依赖、cookie 副作用,再加上一条只在「还慢」时才生效的地理跳转。把页面变快,逼我们把缓存下的跳转也做对——那才是能真正上线的「做完」。