MongoDB为何不允许在$in下嵌套$操作符？报错逻辑解析

问题重现 #

执行以下查询语句：

db.pokemon.find( {
  combats: {
    $in: [
      {"$elemMatch":{opponent:26,winner:2}},
      {"$elemMatch":{opponent:64,winner:2}}
    ]
  } 
} )

会触发报错：

MongoServerError: cannot nest $ under $in

报错背后的核心逻辑 #

• $in的语法限制：$in的设计目标是匹配字段值等于数组中任意一个元素的场景，它接受的数组元素只能是两类：

  1. 基础数据类型（如数字、字符串、日期等）；
  2. 用于匹配子文档的普通文档（即不包含$开头的顶级查询操作符的文档，比如{opponent:26,winner:2}）。
     而$elemMatch是MongoDB的顶级查询操作符，不属于上述两类合法元素，因此直接嵌套在$in的数组参数中会违反语法规则。

• $all为何可以正常运行：$all的设计逻辑是要求数组字段满足所有给定的匹配条件，它的参数数组允许包含多个查询条件（包括$elemMatch这类操作符）。MongoDB会将每个$elemMatch视为独立的检查规则，逐一验证数组字段是否满足所有这些规则，这完全符合$all的功能定位，因此不会触发报错。

等价合法查询写法 #

你可以用$or组合多个$elemMatch条件来实现原查询的需求，写法如下：

db.pokemon.find({
  $or: [
    { combats: { $elemMatch: { opponent:26, winner:2 } } },
    { combats: { $elemMatch: { opponent:64, winner:2 } } }
  ]
})

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