PWA离线时动态内容不可用，因cache.addAll()仅缓存静态快照，无法处理HTML内联JS、API请求及服务端渲染的实时数据；须改用fetch事件拦截+mock响应、本地暂存+同步、分层降级策略。
动态内容在离线状态下不可用是 PWA 最常见的幻觉——cache.addAll() 缓存的只是静态快照，而 HTML 里 fetch('/api/user')、document.getElementById('time').innerText = new Date() 这类行为，离线时必然失败。真要让动态内容“可用”，得放弃“缓存整个页面”的思路，转为分层控制：哪些数据可预存、哪些必须降级、哪些干脆不显示。
为什么 cache.addAll() 对动态 HTML 完全无效
cache.addAll() 只管资源是否能被 fetch() 成功拉下来，不管它里面写了什么逻辑。一个 SSR 渲染的 /dashboard.html，如果服务端返回时带了 Cache-Control: no-store，它连缓存都进不去；就算缓存成功，里面内联的 JS 仍会尝试发起网络请求，离线时直接报 net::ERR_FAILED。
- 动态 HTML（如 Next.js SSR 页面、PHP 渲染页）通常带时间戳、用户态、实时计数器，这些值离线时无法刷新
- 浏览器不会执行 HTML 里的 JS 来“重渲染”，只按缓存那一刻的 DOM 呈现
- 若 HTML 中
<script src="/data.js"></script>被漏进urlsToCache，离线访问时脚本加载失败，整个交互逻辑就断了
用 fetch 事件 + fallback 页面兜底真实请求
真正可行的做法，是在 Service Worker 的 fetch 事件中识别出 API 请求，并返回预置的模拟响应或缓存副本，而不是指望 HTML 自己“活”过来。
- 对
request.destination === 'document'的请求，始终返回已缓存的/offline.html或预渲染的骨架页（避免白屏） - 对
request.url.includes('/api/') || request.destination === 'json'的请求，用caches.match()查找上次成功缓存的响应；没命中则返回一个 JSON 格式的默认数据（如{status: "offline", data: []}） - 关键点：在 install 阶段用
cache.put()手动存入一份离线可用的 mock 数据，例如：cache.put(new Request('/api/latest'), new Response(JSON.stringify(mockData), {headers: {'Content-Type': 'application/json'}}))
前端状态管理必须支持离线写入与同步
用户在离线时点击按钮、填写表单、切换开关——这些操作不能丢，但也不能立刻发请求。需要本地暂存，并在网络恢复后自动重放。
立即学习“前端免费学习笔记（深入）”；
- 用
localStorage或IndexedDB记录待同步的操作队列，结构类似：{type: 'POST', url: '/api/submit', body: {...}, timestamp: Date.now()} - Service Worker 激活后监听
online事件，触发同步逻辑；或在页面里轮询navigator.onLine，调用自定义 sync 函数 - 避免在页面卸载前（
beforeunload）做异步写入，因为浏览器可能直接终止 JS 执行；改用navigator.sendBeacon()发送小量确认数据
最易被忽略的一点：所谓“动态内容可用”，从来不是指“和在线时一模一样”，而是明确界定哪些字段允许 stale（比如用户头像可缓存 24 小时）、哪些操作必须阻塞（比如支付提交）、哪些 UI 必须降级为只读。没有这种分层契约，所有离线方案都会在第一次真实用户操作时崩掉。
