IndexedDB 是异步、事务型、键值对为主的客户端数据库，适合存用户离线笔记、聊天记录、缓存的 API 响应等结构化数据，但不支持 JOIN、GROUP BY 或全文检索，且索引仅支持顶层字段。
IndexedDB 是什么，它适合存什么
IndexedDB 不是“前端版 MySQL”，它是个异步、事务型、键值对为主的客户端数据库，适合存结构化数据（比如用户离线笔记、聊天记录、缓存的 API 响应），但不适合高频小字段读写或复杂 SQL 查询。它原生不支持 JOIN、GROUP BY 或全文检索——这些得自己用 IDBIndex 搭配游标手动模拟。
打开数据库并处理版本升级
每次打开数据库都可能触发 onupgradeneeded，这是唯一能创建/删改对象存储（objectStore）的地方。版本号必须递增，否则升级逻辑不会执行。常见错误是把 db.createObjectStore 写在 onsuccess 里，结果报 InvalidStateError: Failed to execute 'createObjectStore' on 'IDBDatabase'。
const request = indexedDB.open('myAppDB', 2);
request.onupgradeneeded = function (event) {
const db = event.target.result;
// 版本 1 → 2：新增 users 对象存储，并建 email 索引
if (!db.objectStoreNames.contains('users')) {
const store = db.createObjectStore('users', { keyPath: 'id' });
store.createIndex('by_email', 'email', { unique: true });
}
// 版本 2 → 3：新增 posts 存储（后续升级才加）
};
request.onsuccess = function (event) {
const db = event.target.result;
// 此时才能安全使用 db.transaction()
};
增删改查必须走事务，且不能跨事务复用对象
所有读写操作必须包裹在 transaction 中，事务有 readonly 和 readwrite 两种模式。关键限制：事务生命周期极短，一旦事件循环空闲就自动关闭；不能把 objectStore 或 cursor 保存到变量里跨事件回调使用，否则会报 TransactionInactiveError。
- ✅ 正确：每个操作都即时发起，用
transaction.objectStore('name')拿新引用 - ❌ 错误：
const store = tx.objectStore('users'); setTimeout(() => store.get(1), 100) - ⚠️ 注意：
cursor.continue()必须在当前 cursor 有效期内调用，不能等异步回调再 continue
// ✅ 安全的批量写入
function addUsers(db, users) {
const tx = db.transaction('users', 'readwrite');
const store = tx.objectStore('users');
users.forEach(user => store.add(user));
return new Promise((resolve, reject) => {
tx.oncomplete = () => resolve();
tx.onerror = () => reject(tx.error);
});
}
用索引查数据比遍历快得多，但索引字段不能是嵌套路径
IDBIndex 支持按非主键字段快速查找，但只支持顶层属性，比如 createIndex('by_status', 'status') 可以，createIndex('by_user_name', 'user.name') 会静默失败（不报错，但索引无效）。查询时用 index.get() 或 index.openCursor()，别直接用 store.getAll() 后 filter——大数据量下性能断崖式下跌。
立即学习“Java免费学习笔记（深入）”；
// 查所有 status === 'active' 的用户
const tx = db.transaction('users', 'readonly');
const store = tx.objectStore('users');
const index = store.index('by_status');
const req = index.getAll('active');
req.onsuccess = function () {
console.log(req.result); // 数组，含所有匹配项
};
IndexedDB 的复杂性不在语法，而在事务生命周期、索引建模和错误边界处理。最容易被忽略的是：升级时没检查 event.oldVersion 就盲目建 store，导致旧版本用户首次打开时覆盖已有数据；还有就是把大量数据塞进单个事务，触发浏览器强制中止——建议每批不超过 50 条，用递归分片提交。 
