Mongoose 5.x升级8.x后数组字段多元素查询失效问题

问题根源 #

你遇到的是Mongoose版本升级后的查询行为变化：在5.x中，查询数组字段时使用["option2"]会被隐式处理为包含匹配；但8.x严格遵循MongoDB原生规则，此时该写法表示精确匹配数组的全部内容（即数组必须仅包含option2这一个元素），所以原本包含多个元素的tags.tag1无法被匹配。

解决方案 #

要实现数组包含指定元素的查询，有两种简洁写法：

写法1：直接指定元素（推荐）

MongoDB默认对数组字段的单值查询就是包含匹配，无需额外操作符：

{"tags.tag1": "option2", "tags.tag2": "option1"}

写法2：用$in显式声明（适合匹配多个元素的场景）

如果需要匹配数组中存在任意指定元素，可使用$in操作符：

{"$and": [
  {"tags.tag1": {"$in": ["option2"]}},
  {"tags.tag2": {"$in": ["option1"]}}
]}

验证说明 #

修改后的查询会匹配所有tags.tag1数组中包含option2、且tags.tag2数组中包含option1的文档，和你在Mongoose 5.x中的预期行为一致。

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