Web 服务器与网关 / 系统课时

静态资源缓存应该怎么配置

静态资源缓存应该怎么配置

让所有文件都缓存一年,会使用户长时间拿到旧入口;完全不缓存又会反复下载相同脚本。本篇把 HTML 入口与带内容指纹的资源分开设置响应头,并验证缺失资源没有被误加长期缓存策略。

学习目标

  • 为可变 HTML 与不可变资源选择不同缓存策略。
  • 区分 no-cache、no-store 与长时间新鲜期。
  • 验证真实响应头,并把文件命名纳入发布约束。

先保证 URL 与内容的约定

假设构建产物中的脚本名是 app.a1b2c3.js,新内容会生成另一个名称,而不会覆盖同名文件。只有满足这一约定的公开静态资源,才适合一年新鲜期与 immutable。普通的 /assets/app.js 若会原地更新,就不能直接沿用这条策略。

HTML 入口经常改变对资源文件的引用,适合要求使用前重新验证。no-cache 允许存储,但再次使用前要成功验证;no-store 则要求不要存储响应,适用于另外的敏感数据场景,不能把两者当同义词。HTTP 缓存规范定义了这一区别。

按文件类别设置响应头

练习目录 /srv/cache-demo 中准备带换行内容的 index.html 和 assets/app.a1b2c3.js。前者写 cache-entry,后者写 console.log("asset-a");。片段示例:以下站点块放入 http 上下文,所有 /assets/ 文件必须符合前述指纹命名约定。

nginx
server {
    listen 127.0.0.1:8080;
    server_name cache.test;
    root /srv/cache-demo;
    index index.html;
    location = /index.html {
        try_files $uri =404;
        add_header Cache-Control "no-cache";
    }
    location /assets/ {
        try_files $uri =404;
        # 不加 always,避免将本例的资源 404 标为长期可缓存。
        add_header Cache-Control "public, max-age=31536000, immutable";
    }
    location / { try_files $uri $uri/ =404; }
}

31536000 是 365 天的秒数。immutable 表达新鲜期内内容不会改变,并非对文件做完整性校验;客户端是否支持也需要考虑。immutable 规范说明了这一扩展的含义。

查看实际返回的头

配置检查并重载后,在本机执行:

bash
# 只筛选缓存头,避免把动态 Date、ETag 等值写成固定输出。
curl -sSI -H 'Host: cache.test' http://127.0.0.1:8080/index.html | grep -i '^Cache-Control:'
curl -sSI -H 'Host: cache.test' http://127.0.0.1:8080/assets/app.a1b2c3.js | grep -i '^Cache-Control:'
curl -sS -o /dev/null -H 'Host: cache.test' -w 'status=%{http_code}\n' http://127.0.0.1:8080/assets/missing.js

预期输出:

text
Cache-Control: no-cache
Cache-Control: public, max-age=31536000, immutable
status=404

前两个响应状态应为 200,缺失资源不应带本例的长期缓存头。另测 /,它通过 index 内部跳转进入首页规则,也应得到 no-cache。这里只检查服务器策略,不把 curl 本身当作已经实现完整浏览器缓存的证据。

发布时保留旧资源可达

HTML 更新引用新指纹资源,旧指纹文件在保留期内继续可用

先上传新指纹资源,再切换 HTML;旧 HTML 仍可能被打开的页面、缓存或回退版本引用,旧资源不宜立即删除。若前面还有 CDN 或 Service Worker,应分别检查它们的缓存规则,源站响应头正确不保证所有缓存层已更新。

本例基于 Nginx 1.28 的 add_header 规则;在子层新增该指令可能影响上层响应头继承。不要为缓存配置丢掉必要的安全头,也不要同时用多套指令重复添加互相矛盾的 Cache-Control;应查看实际响应的完整头集合再确认。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

静态资源缓存应该怎么配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通