一、问题现象（What）
- 前端发版/优化后，用户访问页面依然展示旧页面、旧逻辑、旧样式
- 按钮点击无反应、样式错乱、新功能不显示、接口报错
- 只有手动清理浏览器缓存 / 强制刷新 Ctrl+F5 后才恢复正常
- 相同环境、相同账号，复现率极高
二、问题出现时间（When）
- 开发完成构建、部署上线后首次访问
- 页面正常刷新（F5）时
- 浏览器未清理缓存的情况下
- 版本迭代、功能优化、样式修改、JS逻辑更新后
三、问题出现位置（Where）
- 前端浏览器缓存机制层面
- JS、CSS、静态资源（图片、字体等）
- 项目构建打包未配置文件名哈希/版本号4. 所有使用浏览器缓存的终端：PC Chrome/Edge、移动端webview等
四、问题为什么出现 & 怎么出现（Why & How）
- 浏览器默认缓存策略文件名相同 → 认为文件未变化 → 直接读取本地缓存，不请求新文件。
- 前端打包未加哈希开发更新代码后，文件名依旧是： app.js 、 index.css 没有变化，浏览器无法识别新版本。
- 服务器未配置正确的缓存头no-cache、no-store、max-age 配置不合理，导致浏览器长期缓存静态资源。
- 最终表现新代码已上线，但浏览器坚持使用旧缓存 → 新旧代码冲突 → 功能异常。
五、测试如何推进开发解决（推进思路）
- 构建工具增加文件名哈希webpack/vite 打包自动生成：app.abc123.js、chunk.f4e5d6.css
- 配置不缓存 index.html入口页面禁止缓存，每次都从服务器拉取
- 服务器配置静态资源缓存头JS/CSS设置长效缓存，HTML设置不缓存 2. 测试提缺陷单要点 - 模块：前端构建 / 缓存策略- 级别：一般（Major）或严重（Critical），影响上线验证效率- 复现步骤：部署新版本 → 普通刷新(F5) → 功能异常 → 清缓存恢复- 影响范围：所有用户、所有页面、每次发版都要人工清缓存 3. 推动落地 - 要求开发修改打包配置- 要求开发验证哈希文件名是否生效- 要求运维/开发检查Nginx缓存配置- 测试验证通过后才能关闭BUG
六、测试如何验收这个BUG（How 验收） 你按下面步骤验证，过了就是修复完成：
- F12 → Network 查看 JS/CSS文件名必须带哈希串：app.xxxxxx.jschunk.xxxxxx.css
- 开发更新代码重新部署 你不清缓存、普通刷新（F5）→ 页面应自动更新为最新版本，无需清理缓存
- 强制回退旧版本再切回新版本 依旧能自动更新，无异常
- 多浏览器验证 Chrome、Edge、移动端都能自动更新
- 最终结论 修复通过标准：发版后不用清缓存，页面自动展示最新内容 如果你愿意，我可以直接帮你生成一条完整可提交的禅道/JIRA缺陷单，你复制粘贴就能用。