教程 · 编程上线
部署成功页面还是旧的：静态资源加哈希，入口文件别缓存
用带哈希的静态资源和短缓存的入口文件，让新版本发布后用户立即拿到更新。
前置：站点部署在 CDN 或服务器上，发布后经常有用户看到旧页面。
材料：构建配置、CDN 控制台、服务器配置、浏览器
材料：构建配置、CDN 控制台、服务器配置、浏览器
步骤
1. 先看响应头缓存策略
在浏览器网络面板看 index.html 和 js 文件的缓存头和命中状态；入口文件被长缓存，用户就会一直加载旧版本。
2. 给静态资源加内容哈希
构建时为 js、css 和图片生成带哈希的文件名，内容变则文件名变；没有哈希就只能靠手动改查询参数，容易漏。
3. 入口文件设为不缓存
把 HTML 的缓存策略设为每次回源校验，让用户拿到最新的资源引用；HTML 缓存住，后面的哈希文件名也失去意义。
4. 发布后刷新 CDN
部署完成后主动刷新入口文件和变更资源的缓存，确认 CDN 边缘节点已更新；只上传不刷新，部分节点还会返回旧内容。
5. 验证版本并保留回滚
在页面里放一个可见的版本号或构建时间，发布后确认线上版本；同时保留上一个版本的产物，出问题能快速回滚。
做完检查
- 新版本发布后刷新即可看到更新
- 静态资源文件名带内容哈希
- 上一个版本可以快速回滚
常见错误
- 所有文件都设长缓存，包括 HTML
- 只上传新文件不刷新 CDN
- 靠用户手动清缓存解决问题
相关工具
同类教程
本地能跑线上 404：先查文件名大小写，再查构建产物
定位大小写、扩展名和路径别名导致的资源 404，用构建产物和大小写敏感环境验证修复。
查看 →密钥被打进了前端包：先分清公开变量和私密变量
识别构建时被内联到前端的变量，把密钥移到服务端并轮换已泄露的凭证。
查看 →单页应用刷新就 404：把未知路径回退到 index.html
配置服务器或托管平台的路由回退规则，让前端路由的深链接刷新和直接访问都能正常打开。
查看 →更新时间：2026-10-29 · 平台规则/软件版本会变；操作前保留原件，以实际页面为准。
跨库学习路径
按共同关键词匹配，不是随机推荐；从任务到提示词/教程/项目继续走。