给想要常见问题解答的人：蘑菇影视官网的缓存管理我这样做

给想要常见问题解答的人：蘑菇影视官网的缓存管理我这样做

在运行蘑菇影视官网多年后，我把缓存管理总结成一套稳健又实用的做法。目标很简单：页面打开快、更新能及时生效、流量成本可控、用户体验稳定。下面把我实际落地的步骤、配置要点和常见问题答案一并整理，方便直接在站点上发布给大家参考。

一、我先做的事：缓存现状审计

• 用浏览器开发者工具查看资源的响应头（Cache-Control、ETag、Expires）。
• 用 curl 检查服务端返回头：curl -I https://your-site.example
• 统计最常访问的静态资源（JS/CSS/图片/视频封面），以及哪些接口响应频繁但不适合长缓存。
• 确定使用的中间组件：CDN（如 Cloudflare）、反向代理（Nginx）、Redis/内存缓存、是否有 Service Worker。

二、核心原则（我遵循的三条）

• 静态资源长期缓存，且通过文件名版本化（内容变更即换名）。
• HTML 页面和需要即时更新的接口短缓存或不缓存，必要时实现按需清除。
• 引入自动化的缓存清理（部署触发或通过 API 清除 CDN/边缘缓存）。

三、静态资源（JS/CSS/图片）的做法

• 构建时给静态资源命名加入哈希，例如 app.3f9a1.js、style.7b2c4.css。这样可以把 Cache-Control 设为长期缓存而不担心更新被阻塞。
• Cache-Control 推荐值：
• 静态资源：Cache-Control: public, max-age=31536000, immutable
• 图片、视频封面等也用长期缓存并版本化
• 对于第三方库或来自 CDN 的资源，尽量使用可信源并开启本地 fallback 策略。

四、HTML 页面和动态内容的做法

• 首页等需要快速更新的页面：
• Cache-Control: no-cache, must-revalidate, max-age=0
• 或：Cache-Control: private, max-age=0, no-store（视需求而定）
• 对于个性化页面（用户登录后的界面），避免边缘缓存或用 Cookie/Cache-Control 来区分。
• 对频繁读但可容忍短延迟的 API（如排行榜）使用短 TTL（例如 30s—60s）并结合后台异步刷新。

五、CDN 与边缘缓存策略

• 在 CDN 上设置路径规则：
• /static/* -> 长缓存
• /api/public/* -> 短缓存或忽略缓存
• / -> 缓存但 TTL 极短或根据请求头判断
• 部署后通过 CDN API 自动清理被版本化资源不需要，但对 HTML 或需要即时替换的资源，在 CI/CD 中触发对应的 purge（按 URL 或按 cache-tag 清除）。
• 使用 CDN 的“缓存键”功能确保带有查询参数或特定 cookie 的请求不误命中缓存。

六、服务端缓存（Redis / 内存）与缓存标签

• 把耗时的数据库查询或第三方接口结果缓存到 Redis，设置合理 TTL（例如 60s、300s）。
• 对应业务对象打上缓存标签（Tagging），方便在数据变更时按标签清除相关缓存，而不必逐条清除。
• 对写操作（例如内容更新、上传封面）在后台触发同步清理：清 Redis + 调用 CDN purge。

七、部署与自动化（我具体的流程）

• 构建阶段生成带哈希的静态资源清单（manifest.json）。
• 部署后触发脚本：
• 将新静态文件上传到 CDN/对象存储（带版本名）。
• 调用 CDN 的 API 清除首页/关联页面缓存（如果需要）。
• 把“部署触发清理”集成到 CI/CD，避免手动操作遗漏。

八、Service Worker（可选，针对离线/客户端加速）

• 若使用 Service Worker：
• 缓存策略分层，静态资源缓存长期，HTML 使用网络优先或网络回退缓存策略。
• 更新 Service Worker 时，确保清理旧缓存并通知客户端刷新页面。

九、实际 Nginx 配置示例（参考）

• 静态资源长缓存： location ~* .(js|css|png|jpg|jpeg|gif|svg|woff2?)$ { add_header Cache-Control "public, max-age=31536000, immutable"; }
• HTML 不缓存： location / { add_header Cache-Control "no-cache, must-revalidate, max-age=0"; }

十、常见问题与解决办法（FAQ）

• Q: 修改了 CSS/JS，但用户仍看到旧文件怎么办？ A: 检查是否未做文件哈希命名；若已哈希，确认页面引用已更新。可建议用户强制刷新（Ctrl+F5），或在部署脚本中触发 CDN 清理。
• Q: 为什么开发环境能实时看到更新，线上却不能？ A: 开发通常禁用缓存或使用不同构建。线上如果开启了 CDN/边缘缓存，必须通过版本化或 purge 来让更新生效。
• Q: 登录后页面缓存导致界面错乱怎么办？ A: 对带认证的请求禁用边缘缓存，或在响应中加入 Vary: Cookie，并在服务端判断是否返回可缓存内容。
• Q: 我怕缓存太短导致流量暴涨，怎么办？ A: 对热点静态资源长缓存，对可容忍延迟的公共 API 采用短 TTL+后台刷新。监控带宽并在必要时调整 TTL。
• Q: 如何检查某个 URL 是否被缓存？ A: curl -I https://your-site.example/path 查看 Cache-Control、Age、Via 等头，或使用 CDN 提供的日志/命中率统计。

十一、监控与调整

• 监控指标：CDN 命中率、源站带宽、响应时间、Redis 命中率。
• 定期回顾：每次上线新功能后查看命中率与用户反馈，必要时微调 TTL 或缓存策略。
• 使用日志与 A/B 测试验证不同缓存策略对用户体验和成本的影响。