MongoDB $lookup返回空数组：ObjectId与字符串匹配关联方案

嘿，这个问题我之前也碰到过！MongoDB的$lookup默认是严格的类型匹配，所以当一边是ObjectId、另一边是字符串时，自然匹配不上，返回空数组很正常。不过别担心，有两种靠谱的方法能搞定这个类型不兼容的关联问题：

方法1：在$lookup的子管道中转换字符串为ObjectId #

这种方法适合你想直接基于原_id字段关联，不需要额外添加字段的场景。我们可以利用$toObjectId操作符，把UsersDetails里的字符串类型userId转换成ObjectId，再和Users的_id匹配：

db.Users.aggregate([
  {
    $lookup: {
      from: "UsersDetails",
      // 把当前Users文档的_id存为变量
      let: { user_object_id: "$_id" },
      // 子管道里处理类型转换和匹配
      pipeline: [
        {
          $match: {
            $expr: {
              // 将UsersDetails的userId转为ObjectId后和变量比较
              $eq: [{ $toObjectId: "$userId" }, "$$user_object_id"]
            }
          }
        }
      ],
      as: "user_details"
    }
  }
])

注意点： #

• 这个方法需要MongoDB 4.0及以上版本（$toObjectId是4.0引入的）。
• 如果UsersDetails的userId字段有索引，这种转换后匹配的方式无法利用索引，如果数据集很大，可能会影响查询性能。

方法2：先将ObjectId转为字符串再关联 #

如果UsersDetails的userId有索引，推荐用这种方法——先把Users的_id转换成字符串，再用普通的localField/foreignField关联，这样能用上索引，性能更优：

db.Users.aggregate([
  // 新增一个字符串类型的userId字段，存_id的字符串形式
  {
    $addFields: {
      user_id_str: { $toString: "$_id" }
    }
  },
  // 用转换后的字符串字段关联UsersDetails的userId
  {
    $lookup: {
      from: "UsersDetails",
      localField: "user_id_str",
      foreignField: "userId",
      as: "user_details"
    }
  },
  // 可选：如果不需要保留转换后的字段，可以用$project移除
  {
    $project: {
      user_id_str: 0
    }
  }
])

注意点： #

• $toString同样需要MongoDB 4.0+版本。如果是更老的版本，可以用$convert操作符替代：{ $convert: { input: "$_id", to: "string" } }。

额外建议 #

如果你的业务场景允许，最好是统一两个集合的字段类型——比如把UsersDetails的userId改成ObjectId类型，这样后续的查询、关联都会更顺畅，也能避免类型转换带来的性能损耗。当然，如果已经有大量历史数据不好修改，上面的两种聚合方法就完全够用了。

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