给网站静态资源设置浏览器缓存:兼顾重复访问与更新生效
图片、CSS和JS每次访问都重新传输,会增加等待和源站流量;缓存时间太长而文件名不变,又可能让用户一直看到旧版本。先区分公开静态资源、页面入口和个人化内容,再设置缓存规则。
一、先看文件更新时会不会改名
| 资源类型 | 可采用的方向 |
|---|---|
| 内容变化就换名称的文件,例如app.7f31c2.js | 可使用较长缓存,发布新版本时引用新的文件名。 |
| 名称固定但经常修改的style.css或图片 | 先用较短缓存,并建立版本更新办法,不直接缓存一年。 |
| HTML入口 | 根据更新需求使用短缓存或每次验证,让它能及时引用新资源。 |
| 账户、订单及其他个人化响应 | 由应用按敏感内容和权限控制缓存,不能套用公开静态规则。 |
只有文件名中包含版本号还不够,发布时必须真的换名且更新引用。把新内容覆盖进同一个长缓存文件,不能要求用户自动得到新版。
二、先在一个明确的静态范围试行
在实际提供公开静态文件的已有Nginx location中,可先加入一小时缓存示例:
expires 1h;
这会为适用响应设置Expires和Cache-Control的max-age。不要再无目的叠加另一条相互冲突的Cache-Control。已有应用、代理或CDN响应头时,先确认由谁负责缓存策略。
对于确认“内容变化必换名”的资源,可以评估更长时长,例如30天;这是配置示例,不是所有网站的固定标准。缓存规则应限定到实际公开静态文件,不能因路径以/assets/开头就认为其中所有内容都安全公开。
如果额外使用add_header,注意当前层新增指令可能影响上层响应头的继承。不要在设置缓存时意外丢掉原有安全响应头。先备份原配置,通过Nginx语法检查后再加载。
三、把响应声明与实际命中分开验证
先用公开资源地址检查实际响应头:
curl -sS --connect-timeout 5 --max-time 15 -I https://www.example.com/assets/style.css
核对Content-Type、Cache-Control、Expires及适用的ETag或Last-Modified。curl重复请求不会自动变成浏览器缓存命中测试;这里主要核对服务器声明。
再在浏览器网络面板保持“停用缓存”未勾选,首次加载后普通访问另一页再返回,观察资源是否来自内存缓存、磁盘缓存或返回304。304表示进行了验证但无需重传完整内容,不代表完全没发请求。
no-cache要求复用前验证,不等于禁止存储;no-store才表达不存储。不要只按名称猜测行为,也不要用公共缓存规则覆盖登录后的个人数据。相关风险见个人化响应被共享缓存。
四、做一次真实的资源更新演练
- 先在测试站发布一个可识别的小改动,使用新的版本文件名,并更新HTML引用。
- 保留旧资源一段合理时间,供仍打开旧页面的用户继续使用,避免发布后立即出现404。
- 用此前访问过的浏览器重新进入页面,确认HTML引用了新文件且内容正确。
- 有CDN时,分别确认源站和CDN的缓存策略,不把清源站文件当成清除所有缓存。
验收应同时满足重复访问减少传输、新版本能按设计生效、个人化页面未被误缓存。若旧内容仍出现,按照缓存分层排查定位具体环节,而不是一次性关闭全站缓存。