静态资源长期缓存的关键是通过构建时注入内容哈希（如app.e4d8c2f3.js）使URL随内容变化，Nginx据此匹配哈希文件并配置强缓存与immutable，同时HTML必须禁用强缓存以确保获取最新哈希引用。
静态资源长期缓存与版本号更新，关键不在“延长有效期”，而在于让浏览器**自动识别内容变化并加载新文件**。Nginx 本身不生成版本号，它只负责根据文件路径特征，精准设置缓存策略。真正起作用的是前端构建时注入的哈希或版本标识。
静态资源加哈希，让 URL 变化驱动更新
JS、CSS、图片等文件必须在构建阶段添加内容哈希（如 app.e4d8c2f3.js），确保：
- 文件内容不变 → 文件名不变 → 浏览器继续用缓存
- 文件内容一变 → 文件名必变 → 浏览器视为全新资源，强制请求
- HTML 中的引用由构建工具自动替换，不能手写固定路径
Nginx 配置匹配哈希文件并设强缓存
用正则识别含哈希特征的文件（如 8 位以上十六进制串），避免误配普通文件：
- 匹配规则示例：
location ~* \.[a-f0-9]{8,}\.(js|css|png|jpg|gif|webp|woff2|ttf|eot)$ - 响应头设为：
Cache-Control "public, max-age=31536000, immutable" - 显式关闭 ETag：
etag off，防止 Nginx 按修改时间生成干扰哈希语义的校验值 - 清空 Last-Modified 字段，避免协商缓存干扰
HTML 必须禁用强缓存，否则哈希白加
入口 HTML 是一切的起点。如果它被强缓存，用户就永远拿不到含新哈希链接的最新 HTML：
- 对
.html文件单独配置：add_header Cache-Control "no-cache, must-revalidate"; - 也可用
private, max-age=0，适合有登录态的页面 - 不设
expires，优先使用Cache-Control，语义更明确、兼容性更好
备用方案：版本路径或 URL 参数（仅限小项目）
若无法接入构建哈希（如纯静态托管或老系统），可手动管理版本：
- 路径方式：
/static/js/app-v2.3.js，上线时改目录或文件名 - 参数方式：
/static/js/app.js?v=20260915，需确保 CDN 不忽略查询参数 - 注意：参数方式在部分 CDN 或代理中可能被剥离，可靠性低于哈希路径
