IndexedDB 存树状组织架构应扁平化建模:节点独立存储,用 parentId 关联,建 byParent 等索引实现高效查询与更新;所有操作须在事务中完成,整棵树宜全量加载后内存构建。

网页端用 IndexedDB 存树状组织架构(比如部门-子部门-员工),核心不是“存一棵树”,而是“存一堆节点,并靠关系还原树”。直接嵌套 JSON 会失去索引能力、查得慢、改得重;正确做法是扁平化建模 + 索引驱动 + 内存构树。
数据模型:用 parentId 扁平存储,别嵌套
每个节点作为独立对象存入 object store,字段至少包含:id(主键)、parentId(null 表示根节点)、name、type(如 "dept" / "employee")、sortOrder(用于同级排序)。不存 children 数组,也不把子节点塞进父节点里。
这样设计的好处:
- 所有节点可被单独增删改查,事务粒度小、响应快
- 能为
parentId建索引,查某部门下所有子部门或员工只需一次索引查询 - 移动节点只需改一个字段(
parentId),不用动整棵树 - 支持按 name、type、sortOrder 等多字段加索引,便于搜索和排序
建库与索引:版本升级时定义好结构
首次打开或升级数据库时,在 onupgradeneeded 中创建 object store 并建索引:
- 用
createObjectStore('nodes', { keyPath: 'id' })创建节点仓库,主键为 id - 立刻调用
store.createIndex('byParent', 'parentId', { unique: false }),这是支撑树形查询的关键 - 按需添加其他索引,例如
store.createIndex('byType', 'type')或store.createIndex('byName', 'name')
版本号必须递增才会触发升级逻辑;已存在的字段不能删,只能新增或忽略旧字段。
常用操作:都在事务中完成
所有读写都必须包裹在事务内,不能裸调用。推荐封装成 Promise 工具函数:
-
插入节点:用
transaction.objectStore('nodes').add(node),确保 id 不重复、parentId 对应存在或为 null -
查某节点的全部子节点:用
index.openCursor(IDBKeyRange.only(parentId))或index.getAll(parentId) -
加载整棵树:先查
parentId === null的根节点,再一次性getAll()拿全量节点,在内存中遍历构建父子关系(比多次异步查快得多) -
移动或删除节点:改 parentId 即可移动;删节点建议先用 byParent 索引递归查出后代 ID 列表,再批量 delete —— 或加
isDeleted字段做软删
性能与健壮性要点
实际使用中容易踩坑的地方:
- 事务生命周期极短,不能缓存
objectStore或cursor实例跨回调使用,每次操作都要重新获取 - 查大量节点时避免逐个
get(id),优先用getAll()或游标分批遍历,防阻塞渲染 - 监听
onerror和onsuccess,尤其 open 和 transaction 失败可能意味着用户禁用了存储、磁盘满或私密模式限制 - 二进制数据(如头像 Blob)可直接存,无需转 base64,节省空间且读写更快











