“IndexedDB 写入失败,控制台报 QuotaExceededError。”这不是数据库坏了,而是源(origin)的存储配额用完了。浏览器给每个源分配的空间是动态的,IndexedDB、CacheStorage、OPFS 等一起计入,写入前最好先估算。
navigator.storage.estimate() 返回当前源的 usage 和 quota,单位是字节:
const { usage = 0, quota = 0 } = await navigator.storage.estimate();
console.log(`已用 ${(usage / 1024 / 1024).toFixed(1)} MB`);
console.log(`配额 ${(quota / 1024 / 1024).toFixed(1)} MB`);
console.log(`占比 ${quota ? (usage / quota * 100).toFixed(1) : 0}%`);quota 是浏览器估算的可用上限,不是固定值。它受磁盘剩余空间、浏览器策略、是否无痕模式影响;同一台机器上,不同源、不同 profile 的结果都可能不同。不要把某个具体数字写死在代码里。
如果只想看是否已持久化,用 navigator.storage.persisted();它返回 boolean,不需要参数。
同一个源下,IndexedDB、CacheStorage、OPFS、localStorage 等通常共享一个配额池。你以为是 IndexedDB 满了,实际可能是 CacheStorage 里的旧缓存占了大头。
排查时先看总量,再按存储类型拆分。estimate() 的 usageDetails 在部分浏览器可用,可以进一步看 IndexedDB/CacheStorage 各占多少;不支持时,用 DevTools → Application → Storage 逐项查看。DevTools 里能看到当前源的 usage,不同浏览器展示项不同,但总量和配额的关系一致。
写入前可以设一个阈值,比如使用率超过 80% 就触发清理:
const { usage = 0, quota = 0 } = await navigator.storage.estimate();
if (quota && usage / quota > 0.8) {
const keys = await caches.keys();
await Promise.all(keys.map((key) => caches.delete(key)));
}清理要有策略:先删过期缓存,再删可重建的数据,最后才动用户数据。不要一上来就 indexedDB.deleteDatabase,那会把离线草稿一起删掉。
如果数据必须长期保留,可以申请持久化存储:
if (navigator.storage && navigator.storage.persist) {
const granted = await navigator.storage.persist();
console.log('persistent:', granted);
}持久化只是降低被浏览器自动清理的概率,不等于无限配额;浏览器仍可能根据策略拒绝或回收。重要数据要有服务端备份,不能只存在浏览器里。
存储配额按源和浏览器 profile 计算。同一个 profile 下切换账号,多个账号共享同一份配额;不同 profile 才各自独立。对多账号运营来说,这意味着一个账号写入大量缓存,可能把同 profile 下其他账号的空间挤掉。
如果 usage 比预期大,先查 CacheStorage 和 Service Worker 缓存,再查 IndexedDB 里是否还留着旧版本的数据库;删除对象仓库不等于立刻释放磁盘,浏览器会在合适时机回收。无痕模式的配额通常更小,不能用它做容量测试。
如果业务把图片、报表、离线数据写进浏览器存储,建议按账号分 profile,或者在应用层按账号前缀分库、分缓存,并设置各自的清理策略。
捕获 QuotaExceededError 时,不要无限重试;先降级写入(只存索引/缩略图),再提示用户清理,或把大文件转到 OPFS/服务端。OPFS(Origin Private File System)也计入同一配额,适合大文件;它不会绕过配额,只是提供更合适的文件接口。
存储配额问题的核心是:先 estimate(),再决定写不写、清不清。配额是动态的,IndexedDB 只是共享池的一部分;持久化能降低被清理的概率,但不能替代容量规划。把监控和清理做进业务,比等 QuotaExceededError 再补救更稳。如果 estimate() 返回 0,可能是浏览器不支持或隐私模式限制;不要把它当成无限配额。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。