MongoDB聚合管道$lookup仅硬编码ObjectId生效问题求助

核心问题原因 #

你在$lookup子管道的$match里直接写tags: '$$tagId'是错误的——常规查询语法不支持识别let定义的聚合变量，MongoDB会把$$tagId当成普通字符串去匹配，自然找不到对应文档。另外，tags是数组类型，得用$in判断变量是否存在于数组中，而非直接用等于判断。

修正后的代码 #

{
  from: "characterengagements",
  let: {
    tagId: "$$ROOT._id" // 前序阶段的_id已是ObjectId，无需再用$toObjectId转换
  },
  pipeline: [
    { 
      $match: {
        $expr: {
          $in: ["$$tagId", "$tags"] // 用$expr启用聚合表达式逻辑，$in判断变量是否在tags数组内
        }
      } 
    },
    { 
      $addFields: {
        tagIdWas: "$$tagId"
      }
    }
  ],
  as: "topCharacters"
}

关键细节说明 #

1. 必须用$expr包裹条件：只有在$expr内部，MongoDB才会解析聚合变量（如$$tagId），常规$match的键值对写法只识别字面量值。
2. 用$in处理数组匹配：硬编码时tags: ObjectId("xxx")能生效是MongoDB的语法糖，自动处理了数组包含逻辑，但使用变量时必须显式用$in来实现匹配。
3. 移除多余的$toObjectId：前序阶段输出的_id已经是ObjectId类型，重复转换可能导致类型不一致，直接引用$$ROOT._id即可。

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