最常见的原因是localField和foreignField类型不匹配，如ObjectId与字符串不等价；需用db.collection.findOne()确认字段值与类型是否一致，并统一类型（如用$toString转换），且$lookup不支持跨库关联（除非MongoDB≥5.0并启用allowDiskUse）。
为什么 $lookup 返回空数组？
最常见的原因是 localField 和 foreignField 类型不匹配，比如一边是 ObjectId，另一边是字符串。MongoDB 不会自动转换类型，哪怕值看起来一样，也会关联失败。
- 用
db.collection.findOne()分别检查两个集合中对应字段的类型和实际值 - 如果目标字段是字符串但源字段是
ObjectId，得在$lookup前加$toString转换（4.0+） - 注意：
$lookup不支持跨数据库关联（除非用from: "db.collection"语法且 MongoDB ≥ 5.0 + 启用allowDiskUse）
如何让 $lookup 关联结果扁平化而不是嵌套数组？
$lookup 默认把匹配结果放进一个数组字段里（如 comments: []），如果只想取第一条或合并字段，得接 $unwind 或 $mergeObjects。
- 一对一关联：后面跟
{$unwind: "$comments"}，但注意这会过滤掉没匹配到的文档；加preserveNullAndEmptyArrays: true可保留 - 想只取最新一条评论：先在
$lookup的pipeline里用$sort+$limit: 1 - 多字段合并到根层级：用
$addFields+$arrayElemAt提取数组首项，再$project展开字段
在聚合管道里多次 $lookup 怎么避免性能崩掉？
每个 $lookup 都可能触发全表扫描，尤其被关联集合没建好索引时，响应时间会指数级增长。
- 确保
foreignField在被查集合上有索引（db.foreignCollection.createIndex({field: 1})） - 尽量把
$lookup放在管道靠前位置，配合$match先缩小主集合数据量 - 避免在
pipeline参数里写复杂逻辑——它会在被关联集合上逐条执行，相当于 N+1 查询 - 超过 10MB 内存限制时，必须加
allowDiskUse: true，否则直接报错Exceeded memory limit
使用 $lookup 时怎么处理缺失关联数据的默认值？
MongoDB 没有 COALESCE 或 IS NULL 这种语法，得靠 $ifNull 或 $cond 手动兜底。
- 如果
$lookup结果是空数组，$arrayElemAt会返回null，这时可用$ifNull: ["$comments.0.name", "匿名用户"] - 想给整个关联对象设默认结构：
$ifNull: ["$profile", {name: "未知", avatar: null}] - 注意：
$ifNull只判断null或缺失字段，对空数组[]不生效，得先用$size判断
关联逻辑越深，$lookup 管道就越容易变成黑盒——字段名拼错、类型隐式转换、索引漏建，任何一个点都会让结果静默失败。调试时优先看单个 $lookup 阶段输出，而不是一口气跑完整管道。
