safari因itp策略可能静默拒绝indexeddb权限，需通过探测open与transaction完成状态判断；必须由用户点击触发requeststorageaccess授权；数据库升级需递增version、监听onversionchange并清理旧连接、在onupgradeneeded中检查索引存在性；不可用时降级为map内存缓存并联网同步。
当你在 Safari 浏览器中调用 IndexedDB 的 add()、put() 或 get() 时突然返回空值、静默失败，或控制台报 SecurityError、InvalidStateError，且该问题只在部分用户、特定页面加载后或切换标签页后复现，说明 Safari 已主动拒绝当前上下文的 IndexedDB 读写权限——这不是代码 bug，而是 ITP（Intelligent Tracking Prevention）策略与 Storage Access 状态不一致导致的运行时拦截。
确认 IndexedDB 权限是否被 Safari 实际拒绝
不要依赖错误是否弹出，而要主动探测：
在页面初始化阶段执行以下探测逻辑：
try { const db = indexedDB.open('test-perm'); db.onerror = () => console.warn('IndexedDB 被完全禁用'); db.onsuccess = (e) => { const testStore = e.target.result.createObjectStore('perm-test'); testStore.transaction.oncomplete = () => console.log('写入权限可用'); }; } catch (e) { console.warn('indexedDB API 不可用，可能是私密模式或系统级禁用'); }
若 【db.onerror 触发且无后续 onsuccess】，说明 Safari 已全局禁用 IndexedDB（如启用“阻止跨站跟踪”+ 未授权站点）；若 【onsuccess 触发但 transaction.oncomplete 不执行】，则是事务层权限被拦，需进入下一步。
强制触发 Storage Access 授权流程
Safari 13+ 中，IndexedDB 在第三方上下文（如嵌入 iframe）、非首屏加载、或跨域跳转后默认无写入权。必须由用户显式交互激活：
方法一：在页面主入口添加授权按钮
插入一个可见按钮：<button id="grant-idb">启用离线功能</button>
绑定点击事件：document.getElementById('grant-idb').onclick = () => document.requestStorageAccess().then(() => location.reload());
注意：此调用必须由用户真实点击触发，自动 click() 或 setTimeout 模拟均无效。
方法二：利用父页面代理（适用于 iframe 场景）
若你的 IndexedDB 页面运行在跨域 iframe 中，父页需先获得 storage access，再通过 postMessage 通知子页重试初始化：
父页执行：document.requestStorageAccess().then(() => iframe.contentWindow.postMessage({ type: 'IDB_READY' }, '*'));
下载 Comet AI 浏览器，体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作，让 AI 成为你的浏览副驾，大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。
子页监听：window.addEventListener('message', e => { if (e.data.type === 'IDB_READY') initIDB(); });
规避 Safari 版本升级阻塞导致的索引不可用
第一步：检查数据库打开时的版本号是否递增
每次新增索引或修改 schema，必须提升 open() 的 version 参数，例如从 indexedDB.open('mydb', 3) 升至 indexedDB.open('mydb', 4)；否则 onupgradeneeded 不会触发，索引不会创建。
第二步：监听并清理旧连接
在 request.onsuccess 回调中立即注册：db.onversionchange = () => { db.close(); location.reload(); };
这一步不可省略——Safari 会因旧标签页持有 v3 连接而永久阻塞 v4 升级，导致新索引始终无法落地。
第三步：在 upgrade 事务中验证索引存在性
在 onupgradeneeded 内，不要直接 store.createIndex('name')，先判断：if (!store.indexNames.contains('name')) store.createIndex('name', 'name'); 避免重复创建报错中断事务。
降级到内存缓存 + 后端同步的兜底方案
当探测到 IndexedDB 完全不可用（如私密模式、企业设备策略禁用），立即启用内存存储：
定义 fallback 存储对象：const memStore = new Map();
所有原本调用 store.put(data) 的地方，改为：memStore.set(data.id, data);
在网络恢复时批量同步：navigator.onLine && syncToServer(Array.from(memStore.values()));
这一步操作起来很简单，直接把文件拖进去就行。
