必须用explain("executionStats")而非默认模式,因其真实执行查询并返回totalKeysExamined>0且stage为IXSCAN才确认走索引;默认queryPlanner仅模拟计划易误判。

直接看 explain("executionStats") 返回里的 totalKeysExamined 和 stage,值为 0 且 stage === "COLLSCAN" 就是没走索引;别信 explain() 默认模式,它只模拟不执行,容易误判。
为什么必须用 explain("executionStats") 而不是默认模式
默认的 explain() 只返回 queryPlanner,它只告诉你“MongoDB 认为该用哪个索引”,但不真正执行查询。实际运行时可能因数据分布、统计信息过期或优化器误判而跳过索引。
-
executionStats是真实执行后的结果,含totalDocsExamined(扫描文档数)、totalKeysExamined(索引条目扫描数)、executionTimeMillis(真实耗时) - 如果
totalKeysExamined === 0且stage === "COLLSCAN",说明完全没用索引 - 如果
totalKeysExamined > 0但totalDocsExamined远大于nReturned,说明索引用了但效率低(比如只匹配复合索引前缀)
stage 和 totalKeysExamined 怎么一起看才准
单看 stage 容易被误导:旧版输出里出现 "cursor": "BtreeCursor" 不代表走了你建的索引,可能只是用了 _id_ 索引做排序或跳过。
- 真正可靠的组合是:
stage === "IXSCAN"+totalKeysExamined > 0 - 如果
stage === "IXSCAN"但totalKeysExamined === 0,说明索引被选中但没实际用于查找(比如只用来去重或排序,且字段未覆盖) - 查
executionStats.executionStages.indexBounds,能看出索引哪段字段被实际约束——比如复合索引{a: 1, b: 1},查询只含b,你会看到a的 bounds 是[MinKey, MaxKey],等于白建
常见导致 totalKeysExamined === 0 的硬伤场景
这些情况即使建了索引也必然失效,得改查询写法或索引结构:
-
$or条件各分支没共用字段,例如{$or: [{x: 1}, {y: 2}]},除非 x 和 y 都有独立单字段索引,否则大概率退化为COLLSCAN - 对索引字段用了表达式或函数,如
{ts: {$gt: {$add: ["$ts", 3600]}}},索引无法下推 -
$regex模式以通配符开头,例如/abc/(缺^),B-tree 索引失效;必须写成^abc才能利用前缀 - 查询字段顺序不满足最左前缀,比如索引是
{name: 1, age: -1},但查询只写{age: 25},MongoDB 不会跳过name去用age
真正难判断的不是“完全没走”,而是“走了但几乎没用”——比如 totalKeysExamined 很大但 nReturned 很小,说明索引范围太宽,实际仍要扫大量键。这时候得结合 indexBounds 和业务查询模式重新设计索引,而不是盲目加字段。


















