Service Worker离线缓存必须分install、fetch、activate三阶段协同控制:install预缓存资源,fetch按destination分流响应,activate清理旧缓存并claim接管;任一环节缺失即导致白屏或加载失败。
Service Worker 缓存策略不是“配个参数就生效”,而是必须分阶段控制:安装时预缓存哪些资源、请求时怎么匹配与回退、激活时如何清理旧版本——漏掉任一环节,离线就会白屏或加载失败。
sw.js 注册失败的三个典型原因
注册静默失败最常见于非安全上下文:
协议、局域网 IP(如
)或未启用 HTTPS 的域名。只有
和
被浏览器视为有效注册源。
检查控制台是否报错
且无堆栈——大概率是协议/域名不合规
必须在
中调用,不能放在 DOM 解析前或异步模块里
确保
文件能被直接访问(比如打开
应返回 JS 内容,而非 404 或重定向)
install 阶段缓存失败的常见陷阱
看似简单,但只要列表中任意一个 URL 返回非 2xx 状态(404、CORS 拒绝、500),整个缓存操作就中断,不会写入任何资源。
路径必须是绝对根路径,比如
合法,
或
会 404
不要包含带查询参数的 URL(如
),不同参数会被当成不同缓存键,导致重复缓存和空间浪费
HTML 文件本身不能只缓存它自己——
里引用的
、
、
必须全部列进
字体、SVG 等资源若跨域或 MIME 不匹配,也会导致
拒绝执行
fetch 事件中怎么区分资源类型做缓存
不能对所有请求一视同仁。HTML 页面必须能离线打开,而 API 接口通常不该返回过期数据——得按
分流处理。
使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
下载
立即学习
“
前端免费学习笔记(深入)
”;
:主页面请求,必须命中缓存,否则离线白屏;建议 fallback 到内置 HTML 字符串或预存的 offline.
html
或
:可走纯缓存优先,用
直接返回
或
:可加 try/catch,fetch 失败时跳过缓存,避免阻塞渲染
或空字符串(如
):适合
:先返回缓存,再 fetch 更新,响应头需设
activate 阶段清理旧缓存为什么总出错
清理动作不是“删掉旧名就行”,必须避开当前正在使用的缓存,否则页面还在读 v1 缓存,你却把 v1 删了,会触发
。
清理逻辑必须放在
事件里,不能放
——此时旧 SW 还在运行
用
这类方式,确保只删“非当前版本”
配合
让新 SW 尽快接管,避免新旧缓存混用
注意:HTTP 缓存(
)和 Cache Storage 是两套独立系统,清理
不影响 disk/memory cache,反之亦然
最易被忽略的是:HTML 文件本身没有缓存生命周期控制能力,所有缓存行为完全依赖 SW 的 install/fetch/activate 三阶段协同;一旦某个阶段逻辑缺失或顺序错乱,离线体验就不可控——这不是配置问题,是状态机逻辑问题。
file://http://192.168.1.100https://http://localhostFailed to register a ServiceWorkernavigator.serviceWorker.register()window.addEventListener('load', ...)sw.jshttps://yoursite.com/sw.jscache.addAll()'/index.html''./index.html''index.html''/app.js?v=2.1'index.htmlapp.jsstyle.csslogo.pngurlsToCacheaddAll()request.destinationdestination === 'document'destination === 'script''style'caches.match(event.request)destination === 'image''font'destination === 'json'fetch('/api/data')stale-while-revalidateCache-Control: max-age=0, stale-while-revalidate=60TypeError: Request failedactivateinstallcaches.keys().then(keys => keys.filter(k => !k.includes('v2')).map(caches.delete))self.clients.claim()Cache-Controlcaches.delete()