旧版 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 用户真实遇到的高频崩溃点。绕过方式不复杂，但容易忽略细节导致整个离线功能失效。
