iOS PWA更新报QuotaExceededError: Failed to OpenBackingStore如何解决

• Safari对添加到主屏幕的独立PWA有严格的域存储配额限制，通常为设备剩余可用存储的10%，配额计算时会将当前域下所有存储类型的占用全部累加：包括Service Worker缓存、IndexedDB数据、DOM缓存、遗留存储数据，且SW更新过程中不会自动提前回收旧版本资源。
• Angular PWA默认的更新逻辑是先完整下载所有新版本缓存资源，下载校验完成后才会删除旧版本对应缓存。你使用的PDFTron-Webviewer本身体积较大，更新版本时旧版Webviewer缓存还未清理，新版资源又要占空间，二者叠加的存储占用很容易触碰到Safari的配额阈值，此时浏览器连IndexedDB的底层存储BackingStore都无法初始化，就会抛出QuotaExceededError: Failed to OpenBackingStore in database because not enough space for domain的错误，Safari开发者工具中的报错表现如下：
  
• 额外加剧问题的点：PDFTron初始化时会自动往IndexedDB写入字体、渲染临时缓存，如果没有做版本隔离，新旧版本的Webviewer IDB缓存会持续叠加占用；加上你存在IndexedDB里的离线PDF/DOC文件本身也占配额，多重因素下更新时很容易超限。
• 你现在用的删除PWA重装的临时方案，本质是清空了该PWA对应域下的所有存储数据，把占用直接清零，所以能暂时恢复，但下次更新大版本资源时还是会复现。
• 这个问题是Safari独有的，Chromium内核浏览器在SW更新时会动态调整配额占用、提前回收可删除的旧缓存，不会出现这类峰值超限问题。

按落地优先级排序：

1. 调整大体积资源的SW更新逻辑，避免新旧缓存峰值叠加 #

• 不要把PDFTron全量资源放到Angular SW的预缓存资源组里，在ngsw-config.json中给PDFTron资源单独配置懒加载资源组：

{
  "assetGroups": [
    // 原有应用核心静态资源配置保持不变
    {
      "name": "pdftron-large-assets",
      "resources": {
        "files": ["/assets/pdftron/**/*"]
      },
      "installMode": "lazy",
      "updateMode": "lazy"
    }
  ]
}

• 监听到SW有新版本可用时，不要直接立即激活新版本，先通过caches.delete()主动删除旧版本下所有带PDFTron路径的缓存条目，确认删除完成后再拉取新版PDFTron资源，从根源上避免新旧大体积资源同时占用存储。

2. 更新前主动做存储清理与配额检查 #

• 应用启动、触发SW更新前，先调用navigator.storage.estimate()查询当前PWA的已用存储和可用配额，如果已用占比超过70%，先主动清理三类冗余数据：
  • 超过保留期限、用户未主动标记为重要的离线存储文档
  • 旧版本PDFTron生成的IDB缓存：给PDFTron使用的IndexedDB库名加版本号后缀，更新时直接删除旧版本号对应的整个IDB库，不要留冗余缓存
  • Angular SW留存的非当前版本的所有缓存条目
• 清理完成后再执行新版本资源下载，把峰值占用控制在配额范围内。

3. 裁剪PDFTron预缓存体积 #

• 把PDFTron中非核心的资源（多语言包、不常用的字体、老旧格式兼容渲染模块）从预缓存列表里移除，改成用户首次用到对应功能时再按需缓存，把SW预缓存的核心资源总体积压到配额阈值的30%以内，给运行时缓存和用户文件留足空间。

4. 增加错误兜底逻辑 #

• 在全局Promise异常捕获中识别到QuotaExceededError时，自动清理所有非用户手动保存的缓存类数据（SW缓存、PDFTron运行时缓存），保留用户存在IDB里的个人文档，清理完成后提示用户刷新页面即可恢复，不需要用户手动删除PWA重装。

内容的提问来源于stack exchange，提问作者Chris_272