IndexedDB是需规则驱动的本地数据库系统,依赖结构设计、事务控制与查询策略协同;须通过onupgradeneeded显式升级版本并管理索引;所有操作必须封装在事务中;大数据量需用游标或索引范围查询;容错需监听错误、降级缓存并监控存储空间。

IndexedDB 不是“高级 localStorage”,而是一套需要按规则运转的本地数据库系统。它在复杂应用中真正发挥作用,靠的不是功能堆砌,而是结构设计、事务控制和查询策略的协同。
明确数据模型与版本演进路径
数据库结构不能靠临时改写代码来调整。每次升级必须通过 onupgradeneeded 显式定义 object store 和索引,且版本号必须递增。
- 首次建库时指定初始版本(如 v1),创建
users、files等 object store,并设置keyPath: 'id'或启用autoIncrement - 后续新增字段或调整查询逻辑(比如要按
updatedAt排序),需升到 v2,在升级回调里新建索引:store.createIndex('updated', 'updatedAt', { multiEntry: false }) - 避免直接删除旧索引——浏览器不保证兼容性;应先读取旧数据迁移,再在新版本中停用旧索引
用事务封装真实业务操作
所有读写都必须落在事务内,这不是可选项,而是强制约束。事务类型(readonly / readwrite)直接影响并发行为和错误边界。
- 批量导入用户数据时,用一个
readwrite事务包裹全部put(),失败则整体回滚,不会出现“存了一半”的脏状态 - 渲染前查列表页,用
readonly事务获取分页数据 + 总数,避免写锁干扰其他操作 - 事务生命周期短:一旦所有请求完成或出错,事务自动关闭;不要试图复用事务对象跨异步任务
针对大数据量做查询优化
当记录数超过千条,get() 和 getAll() 就不再适用。游标(cursor)和索引范围查询才是可控手段。
- 按时间倒序加载最新 50 条日志:用
index.openCursor(null, 'prev')配合continue()控制迭代次数 - 模糊搜索商品名:建立
name索引后,用IDBKeyRange.bound('手机', '手机\uffff')获取前缀匹配结果 - 避免一次性拉全量数据:即使总条数已知,也应按需分页,防止内存溢出或页面卡顿
容错与降级必须前置设计
IndexedDB 在部分场景下可能不可用(如隐私模式、磁盘满、Safari 限制严),不能只依赖 success 回调。
- 每个 open、transaction、request 都监听
onerror,区分是权限拒绝、配额超限还是语法错误 - 关键数据写入失败时,降级到 localStorage 缓存原始 payload,并标记“待同步”,网络恢复后重试
- 用
navigator.storage.estimate()定期检查可用空间,提前预警而非静默失败











