IndexedDB错误处理必须绑定IDBRequest的onerror事件，不可用try/catch捕获，因API为事件驱动；每个请求需单独监听onerror并解析event.target.error，推荐Promise封装统一错误流。
IndexedDB 的错误处理不能依赖 try/catch 包裹异步操作，因为它的 API 基于事件驱动（如 onsuccess、onerror），而非 Promise。错误必须在对应事件处理器中捕获和响应。
错误只发生在 onerror 事件里
IndexedDB 的所有异步操作（open、add、get、put 等）都返回 IDBRequest 对象，它本身不抛出同步异常。真正出错时，会触发该对象的 onerror 回调，同时 event.target.error 提供具体错误信息。
- 不要对
db.transaction(...)或objectStore.add(...)做 try/catch —— 它们不会 throw - 每个
IDBRequest实例都要单独设置onerror，否则错误会被静默忽略 -
onerror触发时，event.target就是那个失败的 request，可从中读取error.name（如 "AbortError"、"QuotaExceededError"）和error.message
推荐用 Promise 封装来统一错误流
手动写 onsuccess/onerror 易遗漏，用 Promise 包一层更可控，也能配合 async/await：
function promisifyRequest(request) {
return new Promise((resolve, reject) => {
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
}
// 使用示例
async function addItem(db, storeName, value) {
const tx = db.transaction(storeName, 'readwrite');
const store = tx.objectStore(storeName);
const req = store.add(value);
try {
await promisifyRequest(req);
} catch (err) {
console.error('添加失败:', err.name, err.message);
throw err;
}
}
关键错误类型和应对建议
常见错误有实际含义，需区别对待：
立即学习“Java免费学习笔记（深入）”；
-
"VersionError"：open 时传入 version ≤ 当前库版本 → 需调用
setVersion（旧版）或升级 version 并监听onupgradeneeded - "AbortError"：事务被显式 abort 或前置操作失败 → 检查事务是否已提交/冲突，避免跨事务复用对象
-
"NotFoundError"：访问不存在的 objectStore 或 index → 确保
onupgradeneeded中已创建 -
"ReadOnlyError"：对只读事务执行写操作 → 确认 transaction mode 是
'readwrite' -
"UnknownError" / "ConstraintError"：数据格式或主键冲突 → 校验输入，或用
put()替代add()覆盖重复键
全局兜底：监听 window 上的 unhandledrejection（仅限 Promise 封装后）
如果你统一用了 Promise 封装，但某处忘了 await 或 catch，可以加一层防御：
window.addEventListener('unhandledrejection', event => {
if (event.reason?.name === 'AbortError' || event.reason?.name?.includes('Error')) {
console.warn('未捕获的 IndexedDB 错误:', event.reason);
// 可上报、提示用户或触发降级逻辑（如 localStorage 备份）
}
});
注意：这不替代具体 request 的 onerror，只是最后一道防线。
