MongoDB聚合$match阶段使用$in报‘$in needs an array’错误求解

核心问题出在MongoDB聚合管道中**$match阶段的语法规则**：

• $match阶段默认遵循MongoDB的「查询过滤器语法」，和普通find()查询规则一致。在这种语法下，$in操作符的右侧必须是常量数组，不支持以$开头的字段引用。
• 当你写$in: "$requested_categories"时，MongoDB不会把它解析为对文档字段的引用，而是直接将"$requested_categories"当成字符串字面量。此时$in检测到右侧不是数组，就会抛出「$in needs an array」的错误。
• 只有在聚合表达式上下文（比如$expr、$project、$addFields等阶段）中，$开头的标识才会被解析为字段引用，这时候$in才能接受字段引用作为数组参数。

举个例子，如果要基于文档内的requested_categories字段做筛选，需要用$expr把查询逻辑切换到表达式语法：

{
  $match: {
    $expr: {
      $anyElementTrue: {
        $map: {
          input: "$my_categories",
          as: "cat",
          in: { $in: ["$$cat", "$requested_categories"] }
        }
      }
    }
  }
}

而如果requested_categories是外部传入的数组（比如接口获取的参数），直接把数组常量传入$in即可——这也是你直接传数组常量能正常工作的原因。

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