HTML无法自动清理离线缓存,必须由Service Worker在activate事件中显式调用cache.delete()清理旧缓存,且需避开当前正在使用的缓存版本。

HTML 本身不支持自动清理离线缓存
浏览器不会因为 HTML 文件里写了什么就自动删掉缓存——HTML 是静态文档,没有执行能力,更不参与缓存生命周期管理。所谓“离线内容自动清理”,实际依赖的是 Service Worker 的逻辑控制,或者 HTTP 响应头(如 Cache-Control)的声明式策略。
常见错误现象:index.html 更新了,但用户打开还是旧版;PWA 离线时加载的资源明明已废弃,却一直留在 cache storage 里。
-
Service Worker必须显式调用cache.delete()或cache.keys().then(keys => keys.forEach(key => cache.delete(key)))才能清理 - 仅靠修改
index.html中的注释、时间戳或标签,对已安装的 SW 缓存无效 -
Cache-Control: max-age=0或no-cache只影响网络请求阶段,不影响 SW 已存入cache storage的条目
Service Worker 中如何安全清理过期缓存
清理动作必须绑定在 SW 的 activate 事件中,且要避开当前正在使用的 cache(比如页面还在用的 v1 缓存),否则会触发 TypeError: Request failed。
使用场景:发布新版本后,希望用户下次访问时自动弃用旧缓存、启用新缓存。
- 给每个缓存起带版本号的名字,例如
'pages-v2'、'assets-v2',避免直接复用'pages'这类无版本名 - 在
activate回调里用self.clients.claim()确保新 SW 尽快接管,再遍历cacheNames删除不含当前版本号的缓存 - 不要在
install阶段清理旧缓存——此时旧 SW 可能仍在运行,删除会导致页面请求失败
示例片段:
self.addEventListener('activate', event => {
const currentCaches = ['pages-v2', 'assets-v2'];
event.waitUntil(
caches.keys().then(keys =>
Promise.all(
keys.map(key => !currentCaches.includes(key) && caches.delete(key))
)
)
);
});
HTTP 缓存头与 Service Worker 缓存的关系
两者共存但互不感知:Cache-Control 控制的是 HTTP 缓存(memory/disk cache),而 caches.open() 操作的是独立的 Cache Storage API 存储空间。一个资源可能同时存在于两个地方,清理逻辑必须分开处理。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
性能影响:如果 HTTP 缓存没设好,每次 fetch 都穿透到网络,即使 SW 已缓存也会多一次不必要的检查;反之,若 SW 缓存未及时更新,用户看到的就是 HTTP 缓存 + SW 缓存双重过期的结果。
- 对 SW 自己
fetch的资源,建议响应头设为Cache-Control: no-store,避免 HTTP 缓存干扰 SW 的精确控制 - 对非 SW 管理的普通页面资源(如直接
<script src></script>),仍需靠Cache-Control或文件名哈希来规避浏览器缓存问题 - Chrome DevTools 的
Application > Cache Storage和Network > Size列要分开看,不能只查一个
localStorage 或 indexedDB 能替代缓存清理吗
不能。它们和 Cache Storage 是三套完全隔离的存储机制,各自有不同用途和生命周期规则。localStorage 不支持存储二进制资源(如图片、字体),indexedDB 虽可存任意数据,但没有内置的缓存匹配、请求拦截、离线响应等能力。
容易踩的坑:有人试图把 HTML 字符串存在 localStorage 里,再用 document.write() 注入,这既无法支持 CSS/JS 加载,又绕不开同源限制和 CSP 报错,还让离线资源失去 service worker 的统一调度能力。
- 想做资源版本标记?用
caches.keys()查缓存名比读localStorage.getItem('version')更可靠 - 想存配置或用户数据?用
indexedDB;想存可被fetch拦截并返回的响应?只能用caches.open() - 清理操作一旦写错(比如删错了 cache name),可能导致整个 PWA 离线白屏,且无回滚机制
真正难的不是写几行 cache.delete(),而是搞清哪个 cache 正在被哪个 client 使用、哪些请求走的是 HTTP 缓存、哪些走的是 SW 缓存——这些边界稍不注意,清理就会变成破坏。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










