本文介绍使用 mongodb 聚合管道（aggregation pipeline）精准筛选满足「商品所属分类 id 匹配 + 其关联库存中存在 color="red"」条件的 product 文档，解决 `populate().match()` 无法过滤父文档的常见痛点。
在基于 Mongoose 的电商类应用中，常需根据分类（Category）和库存属性（如颜色、尺寸）联合筛选商品（Product）。但你很快会发现：populate({ match: ... }) 只能过滤被填充的子文档，而不能排除不满足子文档条件的父文档——这正是你遇到的核心问题。
你的数据模型中：
- Product.categories 是引用 Category 的 ObjectId 数组；
- Product.stocks 是引用 Stock 的 ObjectId 数组；
- Stock.color 字段存储颜色字符串（如 "red"）；
目标是：获取所有 属于 req.categoryId 分类，且 至少有一条关联 Stock 的 color === req.query.color 的商品。
✅ 正确方案：使用 aggregate() 配合 $unwind + $lookup
Mongoose 的 find() + populate() 在此场景力不从心，必须升级为聚合查询。以下是经过验证的完整解决方案：
const mongoose = require('mongoose');
// 确保 req.categoryId 是合法 ObjectId（避免类型错误）
if (!mongoose.Types.ObjectId.isValid(req.categoryId)) {
return res.status(400).json({ error: 'Geçersiz kategori ID' });
}
const color = req.query.color || 'red';
const products = await Product.aggregate([
// 步骤 1：筛选属于指定分类的商品
{ $match: { categories: new mongoose.Types.ObjectId(req.categoryId) } },
// 步骤 2：展开 stocks 数组（每个 stock 生成一条独立记录）
{ $unwind: '$stocks' },
// 步骤 3：用 $lookup 关联 Stock 文档（等价于 populate）
{
$lookup: {
from: 'stocks', // 注意：collection 名称（小写复数），非 model 名
localField: 'stocks',
foreignField: '_id',
as: 'stocks'
}
},
// 步骤 4：展开 lookup 结果（因 $lookup 返回数组，需再次 unwind 才能访问字段）
{ $unwind: '$stocks' },
// 步骤 5：筛选 color 匹配的记录
{ $match: { 'stocks.color': color } },
// 步骤 6（可选）：去重，避免同一商品因多条匹配 stock 出现多次
{ $group: { _id: '$_id', product: { $first: '$$ROOT' } } },
// 步骤 7（可选）：恢复原始结构（去掉 _id 分组包装）
{ $replaceRoot: { newRoot: '$product' } }
]).exec();? 关键说明：from: 'stocks' 必须填写实际 collection 名（默认为 model 名小写复数），可通过 Stock.collection.name 确认；两次 $unwind 是必需的：第一次解构 ObjectId 数组，第二次解构 $lookup 返回的单元素数组；$group + $replaceRoot 保证每个商品只返回一次，即使它有多个红色库存。
⚠️ 注意事项与优化建议
-
性能提示：该聚合在 categories 和 stocks 字段上建立索引可显著提速：
// 在 Product Model 中添加 ProductSchema.index({ categories: 1 }); // 在 Stock Model 中添加（若频繁按 color 查询） StockSchema.index({ color: 1 }); 空库存处理：若某商品 stocks 数组为空，$unwind 会直接丢弃该文档。如需保留无库存商品（仅标记“缺货”），可改用 $lookup 的 preserveNullAndEmptyArrays: true 选项，并配合 $cond 处理。
-
扩展性：后续如需同时按 color 和 size 过滤，只需在最终 $match 中追加条件：
{ $match: { 'stocks.color': color, 'stocks.size': req.query.size } }
✅ 总结
当业务逻辑要求「父文档必须满足子文档的某个条件」时，请果断放弃 populate().match()，转而采用 Model.aggregate() —— 它提供真正的关系型过滤能力。上述聚合流程清晰、可读性强，且完全兼容你的现有 Schema 设计，可直接集成到 GET /api/products/:slug 路由中（配合 convertToSlugToCategoryId 中间件），实现精准、高效、可维护的商品筛选。
