OBS 静态站点托管:缓存头与回源策略的取舍

举报
yd_299686804 发表于 2026/11/08 15:37:04 2026/11/08
【摘要】 把构建产物放进对象存储并开启静态网站托管,五分钟就能得到一个能访问的站点。真正决定体验的是三件事:缓存头怎么给、回源怎么配、错误页怎么兜。这三件事配错,代价分别是「用户看到旧页面」「回源流量翻倍」「改版后 404 到处飘」。 静态站点里,文件的生命周期完全不同。按类型分组是最省心的做法: | 类型 | 示例 | Cache-Control | 理由 | |---|---|---...
# OBS 静态站点托管:缓存头与回源策略的取舍 ## 一、静态托管不是「传上去就完事」 把构建产物放进对象存储并开启静态网站托管,五分钟就能得到一个能访问的站点。真正决定体验的是三件事:**缓存头怎么给、回源怎么配、错误页怎么兜**。这三件事配错,代价分别是「用户看到旧页面」「回源流量翻倍」「改版后 404 到处飘」。 ## 二、缓存策略:按文件类型分层 静态站点里,文件的生命周期完全不同。按类型分组是最省心的做法: | 类型 | 示例 | `Cache-Control` | 理由 | |---|---|---|---| | 带指纹的构建产物 | `app.9f3c1e.js` | `public, max-age=31536000, immutable` | 内容变了文件名就变,可永久缓存 | | HTML 入口 | `index.html` | `no-cache`(可协商) | 必须每次校验,否则改版不生效 | | 图片/字体 | `logo.png` | `public, max-age=604800` | 变更频率低,7 天足够 | | 配置文件 | `config.json` | `no-store` | 含环境差异,禁止任何缓存 | 同一个站点内必须**区分**这三类,否则会出现典型故障:把 `index.html` 也设成一年缓存,发布新版本后老用户刷新仍是旧页面。 实测校验: ```bash curl -sI https://static.example.com/index.html | grep -i cache-control curl -sI https://static.example.com/app.9f3c1e.js | grep -i cache-control # 期望:前者 no-cache,后者 max-age=31536000 ``` ## 三、回源策略:CDN 前面还有一层 对象存储作为源站时,回源有两种写法: 1. **每次校验回源**:CDN 对 HTML 走 `no-cache`,对静态资源走长缓存。这是默认推荐。 2. **强制回源**:通过 CDN 的「回源参数」或存储侧的 `Cache-Control` 覆盖,用于紧急发布。 一个容易踩的坑:**CDN 缓存与存储元数据是两套缓存**。改了对象上的 `Cache-Control`,CDN 仍然按旧策略缓存,必须手动刷新。所以变更流程应该是: ```text 上传新对象(带正确 Cache-Control) → 刷新 CDN 对应 URL 或目录 → 用 curl -I 核对 age / x-cache 响应头确认已生效 ``` 核对是否命中缓存,看响应头: ```bash curl -sI https://static.example.com/app.9f3c1e.js | grep -iE 'x-cache|age|etag' # x-cache: HIT + age>0 表示命中;MISS 表示刚回源 ``` ## 四、错误页与 SPA 路由 单页应用把路由交给前端后,刷新 `/user/42` 会直接请求源站,静态托管找不到该对象就返回 404。两种解法: - **配置错误文档映射**:把 `404` 指向 `index.html` 并返回 `200`(部分托管支持「错误页重写」); - **或使用前端路由的 hash 模式**,代价是 URL 变丑、不利于分享与 SEO。 若走前者,务必确认返回码:返回 `404 + index.html` 的写法会让搜索引擎与监控都判为故障页,应为 `200`。校验: ```bash curl -s -o /dev/null -w '%{http_code}\n' https://static.example.com/user/42 # 期望 200;若是 404 说明错误页映射只改了内容没改状态码 ``` ## 五、多次发布与缓存中毒 最常见的生产事故是「发布后一半用户看到新页面、一半看到旧页面」。原因通常不是缓存策略本身,而是: 1. 构建产物**没有内容指纹**,`app.js` 被 CDN 缓存一年; 2. `index.html` 引用了新的 `app.js`,老 `app.js` 还在缓存里; 3. 回滚时直接覆盖同名文件,缓存继续给出旧版本。 根治方式是「文件名带内容哈希 + HTML 不缓存」,这也是绝大多数前端框架的默认产出策略。回滚时不要覆盖同名对象,而是把 HTML 指向上一版哈希文件。 ## 六、代价与不适用 - **代价一:长缓存 + 指纹意味着存储持续增长**。需要设置旧版本对象的清理规则(如保留最近 30 个版本)。 - **代价二:`no-cache` 的 HTML 会让每次首屏都回源**。流量不大时无所谓,高并发下应在 CDN 侧启用「短 TTL + 预热」。 - **代价三:错误页重写会掩盖真实 404**。需要在前端日志里单独统计被重写的路径,否则真实死链永远不暴露。 - **不适用**:需要按用户身份返回不同内容、或需要服务端渲染的站点,静态托管只能做前置层,不能替代应用服务器。 ## 七、验收清单 1. 三类文件(HTML / 指纹资源 / 配置)的 `Cache-Control` 各不相同,用 `curl -I` 逐项核对; 2. 发布流程包含「刷新 CDN」步骤,并通过 `x-cache` 响应头确认生效; 3. SPA 深链刷新返回 `200`,且行为与首页一致; 4. 构建产物文件名含内容哈希,回滚不覆盖同名文件; 5. 存在旧版本对象的清理规则,且不会误删当前版本。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。