web-playbook-03-cache-and-cdn-…

# CDN缓存导致旧内容泄露：配置安全坑与检查清单

一、常见“坑”点

1. 缓存键未区分关键参数

• 忽略了 Cookie、查询参数、设备类型等，导致不同用户/渠道看到同一份缓存。
• 登录态用户的私有页面被缓存后，可能泄露给其他匿名用户（个人信息泄露风险）。

2. 缓存规则粒度错配

• 对 HTML 动态页面套用了静态资源（图片/CSS/JS）的激进缓存策略。
• 活动页 URL 带营销参数（如 utm_*），部分被缓存、部分回源，用户看到不一致的价格。

3. Edge 与源站双层缓存不同步

• Nginx 的 proxy_cache 与 Cloudflare 边缘缓存 TTL 不一致，清了源站缓存但边缘仍是旧的。
• 缓存清除（Purge）只清了单 URL，漏掉变体缓存（gzip/brotli、移动端版本）。

4. 响应头配置错误

• 源站返回 Cache-Control: public, max-age=...，被 CDN 直接沿用。
• 设置了 Vary 缺失或冲突，导致缓存版本混乱。
• 出错页面（502/503）被缓存后长时间展示。

二、检查清单

活动页/动态内容

• [ ] 活动页 HTML 设置 Cache-Control: no-cache 或极短 TTL（如 30–60 秒），配合 s-maxage 做微缓存
• [ ] 价格类内容改为前端 JS 动态拉取接口，接口路径强制绕过缓存
• [ ] 活动上线/改价时，通过 API 触发 Cloudflare Purge Everything 或按 URL/Tag 精准清除

缓存键与变体

• [ ] 确认 Cloudflare Cache Key 是否包含必要的查询参数
• [ ] 登录用户页面：设置 Cache-Control: private, no-store，避免进入共享缓存
• [ ] 检查 Nginx proxy_cache_key 是否与 CDN 缓存键逻辑一致

响应头审计

• [ ] 用 curl -I 抽查活动页，确认 cf-cache-status（应为 DYNAMIC 或 BYPASS）
• [ ] 确保错误响应头带 Cache-Control: no-store，防止 Nginx 缓存异常页

流程保障

• [ ] 大促前做“缓存演练”：改价后多地区、多设备验证内容一致性
• [ ] 建立发布后自动 Purge 的 CI/CD 钩子
• [ ] 监控回源率与缓存命中率，异常突升时排查缓存穿透或配置失效

核心原则：静态资源放心缓存，含价格/用户态的 HTML 默认不缓存，改版必清缓存。