MongoDB中如何对深层嵌套populated字段进行产品筛选

原代码失效原因 #

populate 是主表查询完成后才执行的关联填充逻辑，StorageModel 集合中实际仅存储 catalogProduct 对应的 ObjectId 值，不存在 catalogProduct.category 这个物理存储字段，直接在 find 方法中查询该路径永远无法匹配到结果。
注意：给populate加match配置只能过滤关联返回的子文档，无法过滤主表的返回结果，不满足筛选需求

可行解决方案 #

方案1：二次查询法（写法简单，适合中小数据量场景） #

先查询符合分类要求的目录产品ID，再用ID筛选库存产品：

// 第一步：查询所有关联目标分类的catalogProduct ID
const matchedCatalogProductIds = await CatalogProductModel.distinct("_id", {
  category: { $in: categories }
})

// 第二步：筛选符合要求的StorageModel文档，保留原有populate逻辑
products = await StorageModel
  .find({ catalogProduct: { $in: matchedCatalogProductIds } })
  .skip((page-1)*8)
  .limit(8)
  .populate({path: "catalogProduct", populate: {path: "category", select: "name"}})
  .select('-__v')
  .sort({_id: -1});

方案2：聚合查询（性能更优，适合大数据量/复杂筛选场景） #

通过MongoDB聚合的$lookup关联后再执行筛选：

products = await StorageModel.aggregate([
  // 关联catalogProduct集合
  {
    $lookup: {
      from: "catalogproducts", // 替换为catalogProduct对应模型的实际集合名（默认小写复数）
      localField: "catalogProduct",
      foreignField: "_id",
      as: "catalogProduct"
    }
  },
  // 将lookup返回的数组拆分为单个对象
  { $unwind: "$catalogProduct" },
  // 关联category集合
  {
    $lookup: {
      from: "categories", // 替换为category对应模型的实际集合名（默认小写复数）
      localField: "catalogProduct.category",
      foreignField: "_id",
      as: "catalogProduct.category"
    }
  },
  { $unwind: "$catalogProduct.category" },
  // 按分类ID筛选
  {
    $match: {
      "catalogProduct.category._id": { $in: categories }
    }
  },
  // 排序、分页、字段过滤
  { $sort: { _id: -1 } },
  { $skip: (page - 1) * 8 },
  { $limit: 8 },
  {
    $project: {
      __v: 0,
      // 可自行指定需要返回的字段，如仅保留分类名称：
      "catalogProduct.category.name": 1
    }
  }
])

注意事项 #

• 聚合查询中$lookup的from参数必须填写MongoDB实际存储的集合名称，Mongoose默认会将模型名转为小写复数作为集合名，如果你自定义了集合名请替换为对应值
• 如果允许catalogProduct为空的场景，可给$unwind添加preserveNullAndEmptyArrays: true配置，避免过滤掉关联字段为空的文档

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