本文详解 javascript 中 indexeddb 的分层错误处理机制，涵盖 `idbopenrequest`、事务（`idbtransaction`）和数据请求（如 `getall()`）三级错误捕获策略，指出常见陷阱（如 `db.close()` 过早调用、`onerror` 事件误用、`blocked` 未处理），并提供健壮、可复用的 typescript 实现方案。
IndexedDB 的错误处理并非“一处监听、全局生效”，而是一个严格分层、不可替代的事件驱动模型。简单地为 IDBDatabase 对象设置 onerror（如 db.onerror = …）是无效且误导性的——IndexedDB 规范明确禁止在数据库实例上监听通用错误；所有错误必须在具体操作层级（即 IDBOpenRequest、IDBRequest 或 IDBTransaction）显式捕获。理解这一原则，是构建可靠离线存储逻辑的基础。
? 核心错误层级与职责划分
| 层级 | 对象类型 | 典型事件 | 处理职责 | 是否可被上层捕获 |
|---|---|---|---|---|
| 1. 数据库打开 | IDBOpenRequest | onerror, onblocked, onupgradeneeded, onsuccess | 处理权限拒绝、版本阻塞、结构升级失败等初始化问题 | ❌ 不会冒泡至 IDBDatabase |
| 2. 事务执行 | IDBTransaction | onerror, oncomplete, onabort | 捕获事务内任一请求失败（需通过 event.target.error 获取具体错误） | ✅ 可统一监听（推荐） |
| 3. 数据请求 | IDBRequest（如 store.get(), store.getAll()） | onerror, onsuccess | 处理单次读写操作失败（如键不存在、数据格式错误） | ✅ 最细粒度控制 |
⚠️ 关键误区澄清： request.result.onerror（即 db.onerror）完全无效——IDBDatabase 实例没有 onerror 属性，该代码不会执行，属典型误用。 datarequest.onerror 是正确做法，但若事务中含多个请求，单独监听每个请求不如统一监听 transaction.onerror 更简洁安全。
✅ 推荐实现：基于 Promise 的健壮封装（TypeScript）
以下重构后的 IndexedDBStorage 类遵循最佳实践：
