HTML IndexedDB需要离线存储吗_HTML IndexedDB配合离线存储技巧【含源码】

IndexedDB天生离线，但离“好用”还差几步

一个核心事实需要先明确：IndexedDB 确实是在浏览器本地运行的数据库，它不依赖网络，所以离线读写数据是它的“出厂设置”。但问题来了，“能离线”和“离线好用”完全是两码事。真正的离线可靠性，靠的不是单一技术，而是一套组合拳。

IndexedDB 的数据存在哪？关掉网络后还能读写吗

很简单，数据就存在用户自己的电脑或手机里，具体路径通常隐藏在浏览器管理页面的某个角落，与网络状态毫无关系。只要你页面上的 Ja vaScript 能够正常运行，indexedDB.open() 这个指令就能随时打开数据库大门，进行各种操作。

那为什么有人会觉得离线后 IndexedDB 失效了呢？其实是几个常见的场景误判：

• 页面源文件是远程的，比如你访问的 https://your-app.com，断网后浏览器根本打不开这个页面——这锅 IndexedDB 可不背，是 HTML 文件自身没缓存下来。
• 应用的 Ja vaScript 逻辑依赖网络加载，脚本都没跑起来，自然也就执行不到打开数据库的那行代码。
• 代码设计上存在逻辑漏洞，比如先调用了 fetch() 网络请求，然后再处理 IndexedDB，错误地把网络连通当成了数据库操作的前提。

只用 IndexedDB 远远不够：离线体验的完整拼图

IndexedDB 单独能解决的，只是“本地有地方存动态数据”这一问题。但要打造无缝的离线体验，你得集齐另外两块关键拼图，让它们协同工作：

立即学习『前端免费学习笔记（深入）』；

• Service Worker：它像个忠诚的守门人，可以拦截所有网络请求。离线时，由它将缓存的页面和资源返回给浏览器，确保应用外壳能加载出来。
• Cache API：这是 Service Worker 的“弹药库”，专门用来存储静态资源，比如 JS、CSS、图片等。
• IndexedDB：前面说了，它负责存储动态的、结构化的业务数据，比如用户填了一半的表单、待同步的草稿。

这三者环环相扣。举个例子，你只缓存了资源（Cache API）却没激活 Service Worker，缓存就是摆设；反之，你只用了 IndexedDB 存数据，但没缓存 JS 文件，页面一片空白，数据也根本无法操作。

IndexedDB 离线写入后，怎么能安全地同步到云端？

离线时的写入操作，可以先安心地存在 IndexedDB 里。真正的挑战在于联网之后：如何确保这些数据能“不丢、不重复、不出错”地同步到服务器？这里有几个关键点：

• 给每一条需要同步的记录，都加上两个“标签”：一个全局唯一的 id，一个用于标记同步状态的 syncStatus字段（其值可以是 "pending"、"synced" 或 "failed"）。
• 同步时，先查询所有 syncStatus === "pending" 的记录，按时间顺序一条条发送到服务器。成功后，立刻用 put() 方法更新其状态为 "synced"。
• 网络请求难免失败，这时候一定要捕获错误，把记录状态标记为 "failed" 并保留在队列中，等待下次重试，切忌直接丢弃。
• 考虑到重试机制，服务端对相同 id 的请求必须做幂等处理。简单说，就是“同样的请求执行多次，效果和执行一次相同”，这通常能在数据库层面解决（例如使用 INSERT ... ON CONFLICT DO NOTHING 这类语句）。

下面是一个简化的同步逻辑片段：

const tx = db.transaction(['drafts'], 'readwrite');
const store = tx.objectStore('drafts');
const pending = await store.getAll(IDBKeyRange.bound([0, 'pending'], [Date.now(), 'pending']));

for (const item of pending) {
  try {
    await fetch('/api/drafts', { method: 'POST', body: JSON.stringify(item) });
    item.syncStatus = 'synced';
    await store.put(item);
  } catch (e) {
    item.syncStatus = 'failed';
    await store.put(item);
  }
}

兼容性与存储上限：这些坑最好提前避开

各大现代浏览器都支持 IndexedDB，这没错，但魔鬼藏在细节里：

• Safari 的“小脾气”：它对 indexedDB.databases() 这个枚举所有数据库的方法支持得很晚（iOS 16.4+ 才跟上）。这意味着在之前版本中，你很难知道用户设备上已经存在哪些库，解决方案通常是依赖严格的命名约定，并做好错误兜底。
• 存储上限是个浮动值：它并不是一个固定的数字。比如 Chrome，它会根据当前磁盘的可用空间按比例分配；而 Safari，尤其是在 iOS 上，限制往往更为严格，有时在 50MB 左右就可能触发限制。
• 别把数据库当硬盘：对于超过 10MB 的大文件（如图片、视频），不建议直接塞进 IndexedDB。更佳实践是使用 Cache API 或新的文件系统访问 API（showSa veFilePicker）来存储，在 IndexedDB 里只存它们的引用或哈希值。
• 注意版本升级阻塞：当你需要升级数据库结构（schema）时，如果用户在其他浏览器标签页中还开着旧版本的应用，新版数据库可能会无法打开。这时候需要妥善处理 versionchange 事件，并友好地提示用户。

最后再提一个容易被忽视的点：同步时机的选择。不是一检测到网络恢复就立刻开始疯狂同步。更聪明的做法是，综合监听 na vigator.onLine 变化、监测 fetch 的成功率，并判断当前页面是否处于活跃状态。否则，一个在后台的标签页可能会在用户不知情的情况下耗尽流量或触发服务器的速率限制，反而影响体验。