如何自动转换字符串外键为ObjectId让MongoDB的$lookup聚合生效？

解决这个类型不匹配导致的$lookup失效问题，有两种快速方案：

方案一：聚合查询中临时转换类型（无需修改数据） #

在聚合流程里先把Order集合的字符串类型uid转换成ObjectId，再执行关联查询，有两种写法：

写法1：先新增转换字段再关联 #

db.order.aggregate([
  // 将字符串uid转为ObjectId类型，新增字段uidObjectId
  { $addFields: { uidObjectId: { $toObjectId: "$uid" } } },
  // 用转换后的字段关联User集合
  {
    $lookup: {
      from: 'users',
      localField: 'uidObjectId',
      foreignField: '_id',
      as: 'join'
    }
  }
])

写法2：在$lookup内部直接转换（更紧凑） #

db.order.aggregate([
  {
    $lookup: {
      from: 'users',
      // 定义变量存储当前文档的uid字符串
      let: { uidStr: "$uid" },
      // 在子管道里将字符串转为ObjectId后匹配_id
      pipeline: [
        { $match: { $expr: { $eq: [ "$_id", { $toObjectId: "$$uidStr" } ] } } }
      ],
      as: 'join'
    }
  }
])

方案二：批量修改数据类型（长期根治） #

如果业务允许修改数据，直接把Order集合里所有的uid字段从字符串批量转换成ObjectId，之后就能正常使用常规$lookup查询：

db.order.updateMany(
  {}, // 匹配所有文档
  [ { $set: { uid: { $toObjectId: "$uid" } } } ] // 用聚合表达式修改字段类型
)

两种方案对比：

• 方案一适合临时查询场景，不用改动原有数据；
• 方案二从根源统一字段类型，能避免后续所有类似关联问题，推荐在业务低峰期执行。

内容的提问来源于stack exchange，提问作者Alok