IndexedDB在无痕模式下会拒绝初始化并抛出UnknownError或InvalidStateError，应通过写入试探法提前探测可用性，再按数据用途分级降级至localStorage、sessionStorage或内存Map，并注意Safari中indexedDB可能为undefined。
IndexedDB 在无痕（隐私）模式下会直接拒绝初始化，抛出 UnknownError 或 InvalidStateError，而不是静默失败。所谓“优雅降级”，核心不是绕过限制，而是提前识别、主动规避、提供合理回退路径——不依赖 try/catch 捕获异常再处理，而是先探测再决策。
先探测，再决定是否启用
无痕模式下 IndexedDB 通常表现为：调用 indexedDB.open() 后，onerror 触发，且 event.target.error.name 为 "UnknownError"；更可靠的方式是用“写入试探法”：
- 新建一个临时数据库，尝试添加一条记录
- 监听
onsuccess和onblocked/onerror - 若 1 秒内未成功，或 error.name 包含
"Unknown"/"InvalidState"，视为不可用
示例代码：
function canUseIndexedDB() {
return new Promise((resolve) => {
const req = indexedDB.open('test-db', 1);
let timeout = setTimeout(() => resolve(false), 1000);
req.onsuccess = () => {
clearTimeout(timeout);
req.result.close();
resolve(true);
};
req.onerror = () => {
clearTimeout(timeout);
resolve(false);
};
req.onupgradeneeded = (e) => {
const db = e.target.result;
const store = db.createObjectStore('test');
store.add({ test: 1 }, 1);
};
});
}
降级策略要分层明确
探测失败后，不能简单 fallback 到内存对象或 console.warn，而应按数据用途分级处理：
立即学习“Java免费学习笔记（深入）”；
-
缓存类数据（如商品列表、API 响应） → 降级到
sessionStorage或内存 Map，仅限当前会话有效 -
持久状态类（如用户偏好、表单草稿） → 优先用
localStorage（注意：部分无痕模式也禁用 localStorage，需二次探测） - 关键离线功能（如 PWA 离线资源） → 提前通过 Workbox 预缓存静态资源，不依赖 IndexedDB 存储动态内容
用 Dexie.js 自带的降级钩子
如果你已在项目中使用 Dexie.js（推荐），它提供了更简洁的兜底方式：
- 设置
db.on("error", () => {...})统一捕获底层错误 - 在
open()前加一层包装，结合上述探测函数 - Dexie v4+ 支持
DBOpenOptions.failOnVersionChange，避免因版本冲突引发误判
实际封装建议：
import Dexie from 'dexie';
export async function createSafeDB(name, schema) {
if (!(await canUseIndexedDB())) {
console.warn(`IndexedDB disabled → using memory fallback for ${name}`);
return new MemoryDB(name); // 自定义轻量内存替代实现
}
const db = new Dexie(name);
db.version(1).stores(schema);
return db;
}
别忽略 Safari 的特殊表现
iOS/macOS Safari 在无痕模式下不仅禁用 IndexedDB，还会让 indexedDB 全局对象为 undefined（而非 null）。所以探测前必须先检查：
if (!window.indexedDB) {
// 直接降级，无需再 open
return useMemoryFallback();
}
另外，Safari 17+ 开始对无痕模式下的存储 API 限制更严格，连 localStorage 都可能抛出 QuotaExceededError，因此降级链建议为：
IndexedDB → localStorage（带 try/catch）→ sessionStorage → 内存 Map
