火狐浏览器“建立数据库连接时出错”实为IndexedDB调用失败，主因是配额耗尽（≥45MB）、数据库损坏（Last modified异常）、隐私模式清空或证书异常致Service Worker注册失败；须先通过about:storage查用量与修改时间，再结合Console错误、隐私模式、自动清理设置及Service Worker状态综合排查。
火狐浏览器报“建立数据库连接时出错”，前端实际并未直连数据库，该错误必源于 IndexedDB API 调用失败——可能是配额耗尽、数据库损坏、隐私模式清空、或证书异常导致 service worker 无法注册进而阻断离线存储链路。
确认 IndexedDB 是否真被拒绝写入
打开开发者工具（Ctrl+Shift+I）→ 切到 Console 标签页 → 复现触发错误的操作（如保存草稿、加载离线文章）→ 查看是否有 QuotaExceededError、AbortError 或 UnknownError 报错。若出现 DOMException: Failed to execute 'open' on 'IDBFactory'，说明 indexedDB.open() 调用已中断，问题在浏览器存储层，不是后端接口。
这一步不能跳过：如果控制台无任何 IndexedDB 相关错误，而是报 fetch 失败或 network error，则根本不是数据库问题，应立即转向网络排查。
检查 IndexedDB 配额与实际使用量
在地址栏输入 about:storage 并回车 → 点击顶部 “IndexedDB” 标签页 → 找到你业务域名（如 https://app.example.com）所在行 → 查看 “Usage (bytes)” 值。
立即学习“前端免费学习笔记（深入）”；
若数值 ≥ 45MB，【Firefox 已触发硬性配额限制，后续所有 put/delete 操作都会静默失败】；若 “Last modified” 时间早于你最近一次写入操作超 2 小时，说明数据库文件可能损坏，浏览器无法正确更新元数据，误判空间不足。
注意：这个页面不显示剩余配额，只显示已用字节数——超过 45MB 就必须清理或重建，没有缓冲余地。
排除隐私模式与自动清理干扰
方法一：验证是否启用“退出时清除网站数据”
进入设置 → 隐私与安全 → Cookie 和网站数据 → 检查“退出 Firefox 时清除历史记录”是否勾选 → 若勾选，点右侧“设置…” → 确认“网站数据”子项是否被勾选。【一旦勾选，每次关闭浏览器都会强制清空 IndexedDB，下次打开时需重建数据库；而重建失败会导致 open() 抛 AbortError】
方法二：确认未处于无痕窗口
右上角菜单 → 新建无痕窗口 → 在无痕窗口中访问同一页面 → 若错误消失，说明主配置文件中存在持久化冲突（如 cert9.db 损坏或 storage 文件夹权限异常），问题不在代码本身。
检查 service worker 是否正常注册
第一步：打开 about:debugging#/runtime/this-firefox → 点击“查看附加调试信息” → 找到你的站点 → 查看 “Service Workers” 区域是否显示“已注册”且状态为“激活中”
第二步：若状态为“等待中”或空白 → 点击右侧“卸载” → 刷新页面 → 观察控制台是否出现 Uncaught (in promise) DOMException: Failed to register a ServiceWorker
第三步：若报错，点击地址栏左侧锁图标 → “连接不安全” → 点击“技术细节” → 若显示 SEC_ERROR_UNKNOWN_ISSUER 或 SEC_ERROR_REVOKED_CERTIFICATE，说明证书异常已阻断 service worker 注册，进而使依赖它的 IndexedDB 初始化逻辑（如在 install 事件中预建 objectStore）根本不会执行。
这一步很关键：很多前端把离线缓存逻辑全塞进 service worker 的 install 事件里，一旦注册失败，整个 IndexedDB 初始化流程就跳过了，但错误堆栈里不会直接提示“IDB failed”，只会卡在 open() 返回 undefined 或 Promise 永远 pending。
临时绕过验证快速验证问题归属
方法一：禁用 DoH 对 localhost 的干扰（仅限本地开发）
地址栏输入 about:config → 搜索 network.trr.mode → 双击改为 【5】 → 彻底关闭所有火狐窗口再重开。
方法二：强制重建 IndexedDB 存储目录（紧急恢复）
关闭所有火狐窗口 → 地址栏输入 about:support → 点击“在文件管理器中打开” → 进入配置文件夹 → 找到并重命名 storage 文件夹为 storage_bak → 重启火狐。【此操作会清除当前域名下所有 IndexedDB 数据库，但可立即恢复默认约 50MB 配额】
