在 nginx 中配置页面版本更新缓存,核心做法是结合 `expires` 指令与 url 版本号(如文件名哈希或查询参数),确保浏览器能正确识别资源变更。具体而言,静态资源应设置长期缓存并附带版本号,而 html 主文档需禁用缓存或设置极短过期时间,强制每次请求都检查最新版本。这样既利用了缓存提升加载速度,又通过版本控制解决了更新不及时的问题。

如何为静态资源设置带版本的长期缓存
针对 CSS、JS、图片等静态文件,使用 location 块匹配特定后缀,并通过 expires 指令设置较长的有效期,例如一年。关键在于文件名必须包含版本标识,如 style.v1.css 或 app.a1b2c3.js,当内容更新时,构建工具会生成新的文件名,浏览器因 URL 变化而发起新请求,从而绕过旧缓存。

server {
listen 80;
server_name example.com;
# 静态资源:长期缓存
location ~* \.(css|js|png|jpg|jpeg|gif|ico)$ {
root /var/www/html;
expires 1y;
add_header Cache-Control "public, immutable";
}
# HTML 文件:不缓存
location / {
root /var/www/html;
expires -1;
add_header Cache-Control "no-cache, no-store, must-revalidate";
}
}
上述配置中,静态资源被标记为 immutable,告知浏览器无需再次验证即可直接使用缓存,前提是文件名已变。HTML 文件则通过 expires -1 和 Cache-Control: no-cache 强制每次向服务器确认是否有更新,确保用户始终获取最新的页面结构以引用新的静态资源。
如何处理动态接口或 API 的缓存策略
对于 JSON 数据或 API 响应,通常不建议使用长期缓存,因为数据可能频繁变动。应设置较短的缓存时间或使用 no-cache 策略,让浏览器在每次使用前向服务器发送条件请求(如携带 If-None-Match 或 If-Modified-Since)。若后端支持 ETag 或 Last-Modified,Nginx 可配合返回这些头信息,减少带宽消耗同时保证数据新鲜度。

server {
listen 80;
server_name api.example.com;
location /api/ {
proxy_pass http://backend_server;
# 禁用强缓存,启用协商缓存
add_header Cache-Control "no-cache, no-store, must-revalidate";
add_header Pragma "no-cache";
# 若后端返回 ETag,Nginx 可透传
proxy_set_header If-None-Match $http_if_none_match;
proxy_set_header If-Modified-Since $http_if_modified_since;
}
}
此配置确保 API 调用不会因浏览器缓存导致数据陈旧。通过 proxy_set_header 将浏览器的条件请求头传递给后端,后端可根据资源是否变更返回 304 Not Modified 或新数据。这种机制在保持数据实时性的同时,避免了重复传输未改变的内容。
当 HTML 文件被错误缓存时如何强制刷新
如果开发者发现页面更新后用户仍看到旧版界面,通常是因为 HTML 文件被缓存。此时需检查 Nginx 配置中对应 location 是否误设了 expires 或 Cache-Control 为长期有效。修正方法是明确指定 expires off; 或 add_header Cache-Control "no-cache";,并确保该规则优先级高于其他通用规则。此外,可在 HTML 中引入带有版本号的 JS/CSS 链接,即使 HTML 缓存短暂生效,也能通过资源文件的版本变化触发重新下载。


















