HTML5 manifest 缓存机制已被现代浏览器废弃，更新失效主因是浏览器仅在 manifest 字节级内容变化时触发更新，空格注释无效；需改非注释行内容、禁用强缓存、手动调用 update() 和 swapCache() 并重载页面；应迁移到 Service Worker。

manifest 文件修改后浏览器没重新下载资源

HTML5 的 manifest 缓存机制早已被现代浏览器废弃（Chrome 94+、Firefox 85+、Safari 未实现且无计划支持），但若你仍在维护旧项目，遇到“改了 manifest 文件内容，页面刷新后资源却没更新”，根本原因不是缓存没清，而是浏览器只在 manifest 文件的**字节级内容发生变化**时才触发更新流程——空格、注释、换行变化都不算数。

实操建议：

• 确保 manifest 文件响应头包含 Content-Type: text/cache-manifest，否则浏览器直接忽略
• 每次修改必须变更 manifest 文件中至少一个非注释行的实际内容，例如更新版本号：

  CACHE MANIFEST
  # v2.1.7  ← 这一行必须改动（且不能只是加空格）

• 检查服务器是否对 .manifest 文件启用了强缓存（如 Cache-Control: max-age=31536000），这会导致浏览器根本不重新请求 manifest 文件本身

用 JavaScript 手动触发更新检测失败

调用 window.applicationCache.update() 不生效，通常是因为应用缓存已处于 UPDATEREADY 状态但未执行 swapCache()，或事件监听未覆盖完整生命周期。

关键点：

• update() 只有在缓存状态为 IDLE 时才发起检查；若当前是 DOWNLOADING 或 UPDATING，它会被忽略
• 必须监听 updateready 事件并显式调用 applicationCache.swapCache()，否则新资源不会激活
• 刷新页面前，老缓存仍生效；swapCache() 后需手动重载：

  if (window.applicationCache.status === window.applicationCache.UPDATEREADY) {
    window.applicationCache.swapCache();
    window.location.reload();
  }

浏览器开发者工具里看不到 applicationCache 面板

Chrome 从 63 版本起移除了 DevTools 中的 Application → Cache → Application Cache 面板，Firefox 在 70+ 版本后也彻底弃用。这不是你的操作问题，而是标准淘汰的结果。

替代验证方式：

• 访问 chrome://appcache-internals/（仅限旧版 Chrome，新版已 404）
• 在 Console 中执行 window.applicationCache 查看对象是否存在及状态值
• 更可靠的方法：打开 Network 面板，勾选 “Disable cache”，然后刷新页面，观察资源是否从 from ServiceWorker 或 from disk cache 加载——如果还显示 from AppCache，说明你用的是极老内核

真正该做的事：迁移到 Service Worker

Manifest 缓存无法按需更新、不支持 HTTPS 强制要求、无运行时控制能力，这些问题 Service Worker 全部解决。别再花时间调试 manifest 的更新逻辑。

最小迁移路径：

• 用 navigator.serviceWorker.register('/sw.js') 替代
• 在 sw.js 中用 cache.addAll([...]) 预缓存资源，用 fetch 事件拦截并返回缓存或网络响应
• 更新策略改为：修改 sw.js 文件内容 → 浏览器自动下载新脚本 → 触发 install 和 activate 事件 → 调用 clients.claim() 立即接管页面

manifest 的缓存更新失效，本质是整个机制已死。你现在看到的“不生效”，其实是浏览器在礼貌地假装还在支持它。