$graphLookup在MongoDB 7.0中查不出多层关系，因默认不递归、需显式设maxDepth、correct connectFromField/connectToField，并注意字段名（如"_id"非"id"）、类型一致、startWith用合法表达式；需用depthField/pathField获取路径；性能问题须建索引并用restrictSearchWithMatch；跨集合报错常因集合不存在或字段缺失。
为什么 $graphLookup 在 MongoDB 7.0 里查不出多层关系？
默认情况下 $graphLookup 不会递归展开全部层级，它只在 maxDepth 指定范围内遍历，且必须显式启用 restrictSearchWithMatch 或正确设置 connectFromField/connectToField，否则容易返回空数组或仅第一层结果。
常见错误现象：{ "from": "users", "startWith": { "$literal": [ObjectId("...")] }, "connectFromField": "managerId", "connectToField": "id" } —— 这里 connectToField 写成 "id" 但集合实际字段是 "_id"，导致完全匹配失败。
-
connectFromField必须指向当前文档（或startWith输出）中的字段名，类型要和目标集合的connectToField一致（比如都是ObjectId） -
startWith支持表达式，但不能直接写字符串 ID；要用{ "$literal": ObjectId("...") }或{ "$arrayElemAt": ["$reports", 0] }等合法表达式 -
maxDepth: 0表示只查起始节点自身（不走边），maxDepth: 1才查一层下级
如何让 $graphLookup 返回完整路径而非仅末端节点？
很多人只关注 as 字段输出的扁平列表，却漏掉 depth 和 path——这两个字段需要手动开启：通过 depthField 和 pathField 参数声明，否则查到的结果里根本没有路径信息。
例如想追溯从 CEO 到实习生的完整汇报链：pathField: "path" 会让每个结果节点带一个 path: [ObjectId("ceo"), ObjectId("mgr"), ObjectId("intern")] 数组。
-
depthField值是字符串，如"depth"，会在每个匹配文档中添加该字段表示当前跳数（从 0 开始） -
pathField同样是字符串，如"path"，值为从起点出发经过的所有_id（按顺序）组成的数组 - 如果
startWith是数组（如多个根节点），path中每个元素仍是独立路径，不会合并
使用 $graphLookup 时性能突然变慢甚至超时怎么办？
MongoDB 7.0 默认对 $graphLookup 启用查询优化器，但如果连接字段没建索引、或 restrictSearchWithMatch 条件太松，就会触发全表扫描，尤其在百万级集合上极易超时。
典型表现：explain() 显示 "stage": "COLLSCAN" 或执行时间 >5s，日志出现 "operation exceeded time limit"。
- 务必在
connectToField所指字段（通常是目标集合的_id或业务 ID 字段）上建升序索引：db.users.createIndex({ "managerId": 1 }) - 用
restrictSearchWithMatch缩小搜索范围，比如只查状态为"active"的节点：{ status: "active" } - 避免在
startWith中使用未索引字段的复杂子查询；优先把起点 ID 预计算好再传入
跨集合图查询时遇到“unrecognized field”报错怎么处理？
MongoDB 7.0 对 $graphLookup 的字段校验更严格，如果 from 指向的集合不存在、或 connectFromField 在输入文档中压根没定义（比如字段名拼错、或某些文档缺失该字段），就会抛出类似 "Unrecognized expression '$xxx'" 或 "field 'xxx' is not in the document" 的错误。
这不是语法问题，而是运行时字段缺失导致的 pipeline 中断。
- 先确认
from集合名拼写正确，且当前数据库中真实存在（区分大小写） - 检查
connectFromField是否存在于上游文档中；可用$ifNull: ["$managerId", null]做兜底，避免字段缺失中断 pipeline - 若连接字段可能为
null或数组，需配合$filter或$map清洗，不能直接当标量用
图查询真正难的不是语法，是数据模型是否天然支持边的可逆性与字段一致性——比如 managerId 指向 _id，反过来 reports 数组存的也得是 ObjectId，否则双向遍历就断了。
