Mongoose聚合加$addFields报Arguments must be aggregate pipeline operators错

报错和Mongoose版本、数据库连接配置无关，核心诱因是代码括号位置错误，传入的聚合参数不符合管道格式要求：

• 你当前写的代码中，$addFields配置块被错误包裹在了$match所在的外层对象内部，导致传给aggregate()的第一个参数是畸形结构：该对象顶级属性除了合法的$match聚合操作符，还混入了额外的非法内容，违反了MongoDB聚合阶段“每个阶段对象仅允许存在一个顶级聚合操作符键”的规则，因此Mongoose解析时抛出“参数必须是聚合管道操作符”的错误。
• 你移除$addFields块后错误消失，也能佐证这个问题：此时传入的对象仅剩下$match一个顶级键，符合单个聚合阶段的格式要求，自然不会触发校验报错。
• 你在在线测试环境中能正常运行，是因为在线环境里你按照标准格式配置了聚合管道数组，和本地代码写错括号的结构不一致。

Mongoose的aggregate()方法支持两种合法传参格式：要么传入按顺序排列所有聚合阶段的数组，要么将每个聚合阶段作为独立参数依次传入，你的当前写法既没有将两个阶段包裹为数组，也因为括号错位把两个阶段拼成了一个非法对象。

调整括号位置，将所有聚合阶段放在数组中传入即可，修正后的代码如下：

Products.aggregate([
  {
    $match: {
      $or: [
        { '_id': { $regex: queryRegex } },
        { 'name': { $regex: queryRegex } },
      ]
    }
  },
  {
    $addFields: {
      favorite: {
        $cond: [
          {
            $in: ['xxx', '$favoritedBy']
          },
          true,
          false
        ]
      }
    }
  }
])

补充提示：如果集合中_id字段是默认的ObjectId类型，直接使用正则匹配无法得到预期结果，需要根据实际业务场景调整匹配逻辑。

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