PouchDB find()提示无匹配索引 已创建索引未命中问题排查

PouchDB的Mango查询命中自定义索引失败，核心是复合索引的匹配规则和你的索引设计不匹配，和插件初始化、索引是否创建成功没有关系：

• 首先明确规则：PouchDB（以及底层兼容的CouchDB Mango引擎）的复合索引严格遵循左前缀匹配逻辑，和MySQL等关系型数据库的联合索引规则一致：只有查询条件覆盖了索引字段列表从最左侧开始的连续字段时，查询引擎才能用索引做快速定位，否则就会退化为全表扫描，走默认的_all_docs索引。
• 你创建的user-index字段顺序是_id → username → userAccount → 其余业务字段，但出问题的查询只传了userAccount作为筛选条件，直接跳过了索引最前面的_id、username两个前置字段，引擎根本没法用这个索引快速定位符合条件的记录，自然不会命中，才会抛出无匹配索引的警告。
• 额外提个你代码里的小问题：贴出来的createIndex代码里，fields配置行末尾缺少和name字段分隔的逗号，虽然你调用getIndexes能看到索引存在，说明是贴代码时的笔误，但实际运行时缺这个逗号会直接抛JS语法错误，建议核对下运行代码。
• 另外你把_id放在自定义复合索引的第一位完全是冗余设计：默认的_all_docs本身就是按_id构建的主键索引，自定义索引把_id放最前面除了额外占用存储空间，不会带来任何查询收益。

根据你的实际查询场景调整索引设计即可：

1. 如果你需要同时支持「按用户名查询」、「按账号查询」两个独立的查询场景，不要建一个包含所有字段的大复合索引，分别给两个查询条件建单字段索引就行：

// 支撑按username查询的索引
db.createIndex({
  index: {
    fields: ['username'],
    name: 'user-username-idx'
  }
})
// 支撑按userAccount查询的索引
db.createIndex({
  index: {
    fields: ['userAccount'],
    name: 'user-account-idx'
  }
})

2. 如果你确实要使用复合索引，必须保证查询条件从索引最左侧的字段开始连续匹配。比如保留你原来的索引顺序，那查询userAccount时必须同时传入_id、username的精确匹配条件才能命中索引，这显然不符合你当前的业务逻辑。
3. 不推荐通过find参数里的use_index字段强制指定索引：不符合左前缀匹配规则的情况下，就算强制指定索引，底层还是要扫描全量索引数据，和全表扫性能没有区别，解决不了根本问题。

改完之后重新调用db.explain()查看执行计划，就能看到查询已经命中对应的自定义索引，查询结果里的无匹配索引警告也会消失。

内容的提问来源于stack exchange，提问作者L.Min