Node.js环境下MongoDB find方法genres字段过滤失效问题

你写的{genres: genre}查询语法本身完全正确——MongoDB对数组字段做单值匹配时，直接传入目标值就会自动返回数组中包含该值的文档，你在Atlas控制台能跑通结果也印证了这一点。Node端过滤失效基本是以下两个高频原因：

• 传入函数的genre参数值不符合预期。你的路由是/books/popular/:genre，如果传参时没做url编码、拿到的参数带前后空格、拿到空串/undefined，甚至是路由匹配顺序错了拿到了其他路径片段，都会导致查询条件失效，直接返回按bbeScore排序的全量结果。先在函数里打日志看实际拿到的genre值：console.log('实际入参genre：', JSON.stringify(genre), '长度：', genre?.length)，一眼就能看出是不是参数问题。
• Mongoose的Schema定义错误。如果Books模型里genres字段没有声明为[String]数组类型，错写成了String或者其他类型，Mongoose做查询类型转换时会跳过数组匹配逻辑，导致过滤不生效。

先确认Schema配置正确，再加一层入参校验即可：

// 先检查Book模型Schema，genres字段必须是数组类型
// const bookSchema = new mongoose.Schema({
//   // 其余字段省略
//   genres: [String],
//   bbeScore: Number
// })

const popularBookGenreDB = async (genre) => {
  try {
    // 入参校验，拦截非法值
    if (typeof genre !== 'string' || !genre.trim()) {
      throw new Error('genre参数非法')
    }
    const targetGenre = genre.trim()
    const res = await Books.find({ genres: targetGenre })
      .sort({ bbeScore: -1 })
      .limit(2)
    return res
  } catch (error) {
    throw error
  }
}

另外检查路由对应的控制器PopularBookGenre，确认是取req.params.genre传给这个函数，不要错拿成req.query里的字段，也不要拼错变量名。

如果要改用聚合管道实现，逻辑和find完全一致，用$match阶段做过滤即可：

const popularBookGenreDB = async (genre) => {
  try {
    if (typeof genre !== 'string' || !genre.trim()) {
      throw new Error('genre参数非法')
    }
    const targetGenre = genre.trim()
    const res = await Books.aggregate([
      // 过滤匹配genre的文档
      {
        $match: {
          genres: targetGenre
          // 如果需要不区分大小写匹配，替换成下面的写法
          // genres: { $regex: new RegExp(`^${targetGenre}$`, 'i') }
        }
      },
      // 按bbeScore倒序
      { $sort: { bbeScore: -1 } },
      // 取前2条
      { $limit: 2 }
    ])
    return res
  } catch (error) {
    throw error
  }
}

如果以上修改后还是不生效，检查genres字段的索引是否异常，可以在服务启动时执行一次await Books.syncIndexes()同步模型索引，排除索引损坏导致的查询异常。

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