HTML5中处理IndexedDB在旧版Safari中的兼容性陷阱

旧版 Safari（iOS 10.3–12.1/macOS 10.1–12.1）IndexedDB 存在四大兼容性问题：全局对象名不一致需按序检测；onupgradeneeded 触发严格且易静默失败；objectStore 创建需预判存在性且索引名须小写下划线；事务易超时中止，游标失效需主动校验 active 状态。

IndexedDB 在旧版 Safari（特别是 iOS 10.3–12.1 和 macOS Safari 10.1–12.1）中存在多个未公开或文档不全的兼容性问题，不是简单加个前缀就能解决，而是需要针对性绕过底层限制。

全局对象名不一致且可能为 undefined

旧版 Safari 中 window.indexedDB 可能为 undefined，但实际可用的是 window.webkitIndexedDB 或 window.mozIndexedDB（后者是历史残留，不可靠）。不能只检测 indexedDB 是否存在，必须主动检查所有可能的别名。

• 推荐写法：用数组依次尝试 webkitIndexedDB、mozIndexedDB、indexedDB，取第一个非 undefined 的值
• 注意：即使获取到对象，其 open() 方法在 iOS 11.3 之前仍可能抛出 InvalidStateError，需配合错误兜底

数据库升级事务被静默拒绝

旧版 Safari 对 onupgradeneeded 的触发极为严格：若数据库已存在且版本号未递增，它不会进入升级流程；更隐蔽的是，即使你显式调用 setVersion()（已废弃 API），也可能被忽略或直接报错。

• 避免依赖 setVersion()，改用 indexedDB.open(dbName, newVersion) 并确保 newVersion > 当前版本
• 首次打开时若不确定版本，可先用低版本（如 1）打开，捕获 versionchange 事件再重开高版本
• iOS 11.0–11.2 存在 bug：同一页面多次快速 open 同一库，可能导致 onupgradeneeded 不触发 —— 建议加 50ms 防抖或使用 Promise 锁

Object Store 创建失败但无明确报错

在 Safari 10.1–12.1 中，若在 onupgradeneeded 中重复调用 createObjectStore()（例如缓存逻辑未判断 store 是否已存在），会静默失败，后续 transaction.objectStore() 报 NotFoundError，而非预期的 InvalidStateError。

立即学习“前端免费学习笔记（深入）”；

• 务必在创建前用 db.objectStoreNames.contains('storeName') 判断是否存在
• 不要在升级回调外操作 objectStore；旧版 Safari 不支持在只读事务中调用 createIndex()
• 索引名称含大写字母或特殊字符时（如 "updatedAt"），某些 iOS 11.3 以下版本会创建失败 —— 建议统一小写 + 下划线

事务自动中止与游标失效

旧版 Safari 的事务生命周期极短：只要 JS 主线程执行超过约 50ms，事务就自动 abort，且不触发 onabort。同时，游标（cursor）在迭代中途若事务关闭，下次 continue() 会抛 TransactionInactiveError，而非返回 done。

• 避免在事务回调中执行同步耗时操作（如 JSON.parse 大数据、正则匹配长文本）
• 批量写入时拆分为每 10–20 条一组，每次新开短事务，用 setTimeout(..., 0) 让出主线程
• 遍历游标时，每次 cursor.continue() 前检查 transaction.active === true，否则重建事务

这些问题不是边缘 case，而是旧版 Safari 用户真实遇到的高频崩溃点。绕过方式不复杂，但容易忽略细节导致整个离线功能失效。