explain() 可分析 find()、updateone()、deleteone()、count()、distinct() 和 aggregate() 的执行计划,但不支持 insertone() 和 insertmany();必须用 "executionstats" 模式获取实际扫描数、返回数、索引键数及真实耗时等关键性能指标。

explain 能分析哪些 CRUD 操作?
explain() 不只适用于 find(),它支持所有核心 CRUD 命令的执行计划分析:包括 find()、updateOne()、deleteOne()、count()、distinct(),以及 aggregate()(需注意 pipeline 阶段限制)。但 insertOne() 和 insertMany() 无法用 explain() 分析——插入本身不走查询优化器,没有“执行计划”可言。
常见误区是以为所有写操作都能 .explain()。实际只有读/改/删类操作才触发查询规划器;插入是直写,explain() 对其调用会报错或返回无效结构。
-
db.users.find({ status: "active" }).explain("executionStats")✅ 可用 -
db.users.updateOne({ _id: ObjectId(...) }, { $set: { name: "a" } }).explain("executionStats")✅ 可用(分析匹配阶段) -
db.users.deleteOne({ age: { $lt: 18 } }).explain("executionStats")✅ 可用(分析删除条件匹配) -
db.users.insertOne({ ... }).explain()❌ 无效,shell 会提示 “not supported” 或返回空对象
为什么必须用 "executionStats" 模式?
默认模式 explain()(即 queryPlanner)只告诉你“理论上怎么查”,不告诉你“实际查了多少”。真正判断性能瓶颈,得看 executionStats 返回的硬指标:
-
nReturned:实际返回文档数 -
totalDocsExamined:扫描的文档总数(旧版叫nscanned) -
totalKeysExamined:扫描的索引键总数(旧版叫nscannedObjects) -
executionTimeMillis:真实耗时(毫秒)
如果 totalDocsExamined 远大于 nReturned(比如 10000 vs 1),说明没走索引或索引选择不当。这时光看 winningPlan.stage 是不够的——可能显示 IXSCAN,但扫描范围过大,仍属低效。
别用 "allPlansExecution" 日常调试:它强制运行所有候选计划,开销大、响应慢,只在怀疑优化器选错计划时才启用。
update/delete 的 explain 容易漏掉什么?
updateOne() 和 deleteOne() 的 explain("executionStats") 输出中,executionStats 部分只反映“匹配阶段”的行为,不包含写入本身的开销。也就是说:
- 它告诉你“找到目标文档花了多少时间、扫了几条”,但不告诉你“修改/删除那条数据花了多久”
- 如果你的
$set更新了带 TTL 的字段,或触发了唯一索引检查,这些额外成本不会出现在executionTimeMillis里 - 复合更新(如
$push+$inc)可能引起文档移动,但explain不体现磁盘重写代价
所以看到 executionTimeMillis 很低,不代表整体操作快——得结合 mongod 日志里的 slowms 或 profiler 数据交叉验证。
聚合管道怎么用 explain?
aggregate() 支持 .explain(),但要注意两点:
- 必须把整个 pipeline 包进
db.collection.aggregate([...]).explain("executionStats"),不能只对某个$match阶段单独加 - 输出中的
stages数组按执行顺序排列,重点看最前面的$match或$lookup阶段的docsExamined和keysExamined - 如果 pipeline 含
$sort且没走索引,executionStats里会出现stage: "SORT"和memUsage: xxx字段——这是内存排序警告信号
示例:db.orders.aggregate([ { $match: { status: "paid" } }, { $group: { _id: "$user", total: { $sum: "$amount" } } } ]).explain("executionStats")。若第一阶段 $match 的 totalDocsExamined 等于集合总文档数,说明 status 缺少索引。
真正难的是多阶段组合的放大效应:一个低效的 $lookup 可能让后续所有阶段输入量暴增,但 explain 只逐阶段展示,需要人工串联推算吞吐压力点。











