无损缓存清理靠URL变更而非删缓存，核心是contenthash驱动文件名变化+nginx长缓存配置；版本路径/vX.Y.Z适用于灰度回滚；PURGE仅用于不可改URL的HTML等资源。
静态资源的“无损缓存清理”不是靠暴力删缓存实现的，而是让旧缓存自然失效、新资源无缝接管。核心在于：**版本号迭代驱动 URL 变更 + Nginx 缓存策略精准配合**。只要路径或文件名一变，浏览器和 CDN 就不会复用旧缓存，彻底规避清理动作本身带来的风险（如误清、延迟、服务抖动）。
用 contenthash 实现自动版本号迭代
这是最推荐、最稳定的方式，构建时自动生成内容指纹，确保“内容变 → 文件名变 → URL 变 → 缓存天然失效”：
- Webpack/Vite 等工具开启
contenthash（不推荐hash或chunkhash，易受无关变更影响） - 生成类似
app.f3a8b2e7.js、style.9d1c45f2.css的文件名 - HTML 中通过构建插件（如
html-webpack-plugin）自动注入带哈希的引用，避免手写出错 - Nginx 对静态后缀统一配置长缓存：
location ~* \.(js|css|png|jpg|gif|woff2?)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}
保留语义化版本号路径（适合人工发布或灰度）
当需要明确区分版本、做灰度或回滚时，把版本号嵌入 URI 路径，比改文件名更直观可控：
- 部署结构示例：
/static/v2.4.1/js/app.js、/static/v2.4.2/js/app.js - Nginx 配置中无需特殊判断，直接按路径前缀缓存：
location ^~ /static/v {
alias /var/www/static/;
expires 1y;
add_header Cache-Control "public, immutable";
} - 前端通过环境变量或配置中心控制加载的
vX.Y.Z路径，发布即切换，零缓存残留
必要时启用 PURGE 接口（仅针对无法改 URL 的资源）
HTML、API 响应或某些 CMS 输出页无法重命名，这时才需主动清理。前提是已编译安装 ngx_cache_purge 模块：
- 定义缓存区：
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=html_cache:20m max_size=200m; - 添加安全清理入口：
location ~ /purge(/.*) {
allow 127.0.0.1;
deny all;
proxy_cache_purge html_cache $scheme$host$1$is_args$args;
} - 更新 HTML 后执行：
curl -X PURGE http://localhost/purge/index.html
注意：该操作只清对应 key，不影响其他资源，也无需重启
避免踩坑的关键细节
很多缓存问题其实源于响应头与缓存机制错配：
-
不要给带哈希的静态资源设短缓存：比如
app.a1b2c3.js配max-age=3600是浪费，应配immutable + 1y -
HTML 必须短缓存 + 协商校验：它不带哈希，但又是资源入口，建议
expires 1m+ETag或Last-Modified，让浏览器每次确认是否更新 -
禁用 proxy_cache 对已由 version/hash 控制的静态文件：Nginx 本地缓存对这类资源是冗余层，反而增加 purge 复杂度；直接
root+expires更轻量可靠
