IndexedDB复合索引不支持动态级联筛选,但可通过预定义字段顺序的索引配合游标与keyRange实现高效多条件查询和排序;必须按查询模式建多个专用索引,且条件需连续匹配索引前缀。

IndexedDB 的复合索引本身不支持“级联筛选”这种动态多条件组合的实时查询,但它能高效支撑固定结构的多字段联合查询和排序——关键在于索引定义方式与游标遍历策略的配合。
复合索引必须按查询模式提前声明
IndexedDB 要求所有查询条件(尤其是范围查询和排序)必须严格匹配索引字段的顺序和连续性。比如你要按 category、status、createdAt 三级筛选并按时间倒序排列,就必须建立如下索引:
objectStore.createIndex('cat_status_time', ['category', 'status', 'createdAt'], { unique: false });
这样你才能用 IDBKeyRange.bound() 精确限定前缀,例如只查 category === 'book' 且 status 在 ['active', 'pending'] 之间的记录,并自动按 createdAt 降序返回。
注意:不能跳过中间字段。比如只用 category 和 createdAt 查询,这个复合索引就无法生效;必须另建一个 ['category', 'createdAt'] 索引。
立即学习“Java免费学习笔记(深入)”;
抓取并分析 OpenClaw JSONL 会话日志,重建并回填代理记忆文件。适用于:(1) 模型切换后记忆不完整,(2) 验证记忆覆盖度,(3) 重建丢失记忆,(4) 通过 cron/heartbeat 自动同步每日记忆。支持简单提取及基于 LLM 的叙事摘要,并自动清理敏感信息。
用游标 + keyRange 实现“类级联”条件过滤
所谓“级联筛选”,实际是多个条件嵌套或依赖关系(如选完分类再筛状态,再按时间排序)。IndexedDB 不支持 SQL 式的 WHERE 链式条件,但可通过以下方式模拟:
- 把最常变、区分度最高的字段放在索引最左侧(如
category),保证起始定位快 - 用
IDBKeyRange.bound([cat, statusLow], [cat, statusHigh], true, true)锁定二级字段区间 - 对游标结果手动做第三层过滤(如
createdAt > timestamp),因为超出索引字段的部分无法用索引加速 - 排序必须由索引字段承担:若需倒序,打开游标时传
{ direction: 'prev' },且索引字段本身要按自然序存储(IndexedDB 默认升序,倒序需靠游标方向控制)
多条件组合建议分场景建多个专用索引
不要试图用一个“万能”复合索引覆盖所有组合。更实用的做法是根据业务高频路径建索引:
-
['userId', 'type', 'updatedAt']→ 个人中心按类型+更新时间查 -
['status', 'priority', 'createdAt']→ 后台任务按状态+优先级+创建时间查 -
['tag', 'score']→ 内容推荐按标签+评分查
每个索引对应一类明确的查询模式。运行时根据用户选择的筛选项,动态匹配最贴合的索引 + keyRange,避免全表扫描。
排序与分页必须配合游标位置管理
复合索引支持排序,但分页需谨慎。例如每页 20 条,第 2 页不能简单跳过前 20 条(性能差),而应记录上一页最后一条的完整键值,作为下一页游标的起点:
// 假设索引是 ['a', 'b', 'c'],上一页最后一条是 ['X', 'Y', 150] const lowerBound = ['X', 'Y', 150]; const range = IDBKeyRange.lowerBound(lowerBound, true); // true 表示排除该值 cursor = index.openCursor(range, 'next'); // 或 'prev' 实现倒序分页
注意:复合键的比较是逐字段进行的,所以 ['X','Y',151] > ['X','Y',150],但 ['X','Z',1] 也大于它——确保你理解键的字典序逻辑。

















