node.js中无法直接调用find().explain()，因mongodb驱动v4.0+已移除该链式方法；必须使用db.command()构造explain命令，指定verbosity并检查executionstats与queryplanner字段。
不能直接在Node.js里对 find() 调用 explain() —— 驱动不支持链式调用，必须走命令行或 command() 接口。
Node.js中无法直接调用 find().explain()
MongoDB Node.js 驱动（v4.0+）已移除对 .explain() 链式调用的支持。你写 collection.find({x: 1}).explain() 会直接报错：TypeError: collection.find(...).explain is not a function。
原因很直接：驱动把查询执行和执行计划分析拆开了——find() 返回的是游标（FindCursor），它没有 explain 方法；而真正触发执行计划分析的是数据库命令 explain，得走 db.command()。
- 别再尝试在代码里模仿 shell 写法，比如
await coll.find(q).explain("executionStats")—— 这永远不 work - shell 里能用是因为 mongosh 封装了命令转发逻辑，Node.js 驱动没做这层胶水
- 如果你用的是 Mongoose，它也**不透出 explain 接口**，底层仍是驱动限制
正确做法：用 db.command() 手动构造 explain 命令
必须显式拼一个 explain 命令文档，传给 db.command()。注意字段名大小写、嵌套层级和集合命名空间格式。
示例（分析 users 集合上 {status: "active"} 的查询）：
const result = await db.command({
explain: {
find: "users",
filter: { status: "active" }
},
verbosity: "executionStats"
});
关键点：
-
explain是顶层键，不是方法；find是其子字段，值为集合名字符串（不是 Collection 实例） -
filter、sort、projection、limit等都得平级写在explain.find对象里，和 shell 中db.users.find(...)的参数一一对应 -
verbosity必须显式指定，推荐用"executionStats"（不是"executionstats"或"EXECUTION_STATS"，大小写敏感） - 如果集合在非默认 database 下，需先获取对应
db实例，不能跨库查
分析返回结果时重点盯哪几个字段？
拿到 db.command() 返回后，别扫全文——直奔 explain.queryPlanner.winningPlan 和 explain.executionStats 两块。
-
executionStats.nReturned：实际返回几条，和你的预期是否一致 -
executionStats.totalDocsExamined：扫描了多少文档，越接近nReturned越好；若远大于，说明索引没滤掉数据 -
executionStats.totalKeysExamined：> 0 才算真用了索引；= 0 就是COLLSCAN -
queryPlanner.winningPlan.stage：值为"IXSCAN"表示走了索引；"COLLSCAN"就是全表扫；"IXSCAN"但totalKeysExamined极小，可能是只用索引跳过前几条，没真正过滤 -
queryPlanner.winningPlan.inputStage?.stage：复合管道下（如带$lookup）要往里钻一层看真实扫描阶段
容易被忽略的坑：权限、连接与调试时机
即使命令语法全对，也可能拿不到有效结果，常见卡点：
- 用户没授
explain权限：至少需要read角色，生产环境常因最小权限原则被砍掉，报错not authorized on ... to execute command explain - 连接的是 mongos（分片集群入口），但
explain命令不会自动路由到 shard，需手动连具体 shard 执行，否则返回空或默认 plan - 在事务里调用
db.command()会失败：MongoDB 不允许在活跃事务中运行explain，报错CommandNotSupportedInTransaction - 调试时误用
queryPlanner模式：它不真正执行查询，totalDocsExamined永远是 0，看不出真实性能，务必用executionStats
真正跑通一次 explain 分析，比加十个日志更早暴露索引设计缺陷。但别把它当常规监控手段——它是诊断工具，不是 API。每次改查询或建新索引后，手动跑一次，比等线上慢查报警更主动。
