Nginx 本身不清理 CDN 或中间代理缓存,但可通过 Cache-Control: public, immutable、哈希路径匹配、显式清空 ETag、精准 proxy_cache_key 及 CDN 控制台配置,确保旧缓存自然失效、新资源被正确长期缓存。

直接结论:Nginx 本身不清理 CDN 或中间代理的缓存,但可以通过 Cache-Control、ETag、proxy_cache_key 和响应头控制,让代理层“只认新哈希、不复用旧缓存”。关键不是清旧,而是让旧缓存自然失效。
如何用 immutable + 哈希路径让 CDN 和浏览器跳过验证
带哈希的文件(如 app.a1b2c3.js)必须声明不可变性,否则 CDN 可能仍走协商缓存流程,甚至忽略 If-None-Match 请求。
-
expires 1y提供兼容性 fallback,但真正起效的是Cache-Control: public, immutable -
add_header ETag ""必须显式清空 —— 否则 Nginx 默认基于 mtime 生成的ETag会随部署时间变化,导致 CDN 认为“文件变了但内容没变”,错误地拒绝缓存或触发无效验证 - CDN(如 Cloudflare、阿里云全站加速)识别
immutable后,会跳过所有条件请求,直接长期缓存该 URL;而新哈希 URL 是全新键值,天然不命中旧缓存
为什么 location 中匹配哈希后缀比单纯按扩展名更安全
仅靠 \.(js|css)$ 匹配,会把未哈希的调试文件(如 debug.js)也套上 immutable,造成更新失败。应优先匹配哈希特征,精准作用于构建产物。
- 推荐正则:
location ~* \.[a-f0-9]{6,}\.(js|css|png|jpg|gif|woff2|ttf)$—— 捕获至少 6 位十六进制哈希,排除人工命名的非哈希文件 - 若构建工具输出 8 位哈希(如 Webpack 的
[contenthash:8]),可收紧为[a-f0-9]{8}\.,避免误伤vendor.123abc45.js类似命名 - 注意:该规则必须放在通用静态资源
location ~* \.(js|css)$之前,否则会被更宽泛的规则覆盖
proxy_cache_key 如何防止 Nginx 自身反向代理层混用版本
当 Nginx 作为源站前的缓存层(例如代理 Vite 预设服务或 Node 构建服务),相同 URL(如 /assets/index.js)在不同发布版本中内容不同,但默认 proxy_cache_key $scheme$proxy_host$request_uri 无法区分版本。
- 需在
proxy_cache_path定义时启用keys_zone,并在location中显式改写缓存键:proxy_cache_key "$scheme$proxy_host$request_uri $http_x_app_version"; -
前端构建后,在 HTML 中注入自定义 header:
,再由 JS 注入X-App-Version到后续请求(或由构建插件统一加 header) - 若无法改前端,可用 Nginx 变量兜底:
proxy_cache_key "$scheme$proxy_host$request_uri $request_time";—— 但此方式会导致每次请求都穿透缓存,仅作临时应急
index.html 不缓存却仍看到旧页面?检查这几个地方
最常见的“配置写了却不生效”,往往不是逻辑错,而是被覆盖或绕过。
-
location = /index.html必须写成精确匹配(=),不能写成~* \.html$—— 后者可能匹配到/404.html等,且优先级低于更具体的规则 - 确认没有其他
include的 conf 文件里重复定义了location = /index.html,Nginx 加载顺序靠后的会覆盖前面的 - 检查是否启用了
gzip_static on且存在index.html.gz:Nginx 会优先返回压缩版,而你的缓存头可能只加在非压缩块里 - 浏览器 DevTools → Network → 点开
index.html→ 查看 **Response Headers** 是否真包含Cache-Control: no-cache,而不是只看 Nginx 配置文件
最易被忽略的一点:CDN 缓存策略独立于 Nginx 响应头。即使你返回了 no-cache,CDN 仍可能按自己规则缓存 HTML。务必登录 CDN 控制台,将 *.html 或 /index.html 单独设置为「不缓存」或「缓存 TTL=0」——这个动作不能省,Nginx 控不了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











