本文介绍使用 mongodb 聚合管道（aggregation pipeline）精准筛选满足「所属分类 id 匹配 + 关联库存中存在 color="red"」条件的商品，解决 `populate().match()` 无法过滤父文档的限制。
在基于 Mongoose 的电商项目中，常需实现类似 GET /api/products/cell-phone?color=red 的接口：返回 slug 为 cell-phone 的分类下，所有至少拥有一条 color="red" 库存记录的商品。但直接使用 find().populate({ match: ... }) 是无效的——因为 populate 的 match 仅用于过滤被填充的子文档，而不会影响主集合（Product）的返回结果（即：即使某商品所有库存都不是 red，它仍会被查出，只是其 stocks 字段为空数组）。
✅ 正确解法是采用 MongoDB 聚合管道（aggregate），通过 $unwind + $lookup + $match 组合实现「先关联、再筛选、后去重」的逻辑。以下是推荐的完整实现：
// 在 ProductController 中（例如 listByCategoryAndColor 方法）
const mongoose = require('mongoose');
exports.listByCategoryAndColor = async (req, res, next) => {
try {
const categoryId = new mongoose.Types.ObjectId(req.categoryId);
const targetColor = req.query.color || 'red';
const products = await Product.aggregate([
// 步骤 1：筛选属于目标分类的商品（注意：categories 是 ObjectId 数组）
{ $match: { categories: categoryId } },
// 步骤 2：展开 stocks 数组，使每个 stock 单独成一条流水线文档
// （一个商品有 3 条库存 → 展开后产生 3 条中间文档）
{ $unwind: '$stocks' },
// 步骤 3：用 $lookup 关联 Stock 集合，将 stocks 字段从 ObjectId 替换为完整 Stock 文档
{
$lookup: {
from: 'stocks', // 注意：此处为集合名（小写复数），非模型名
localField: 'stocks', // Product 文档中的 stocks 字段（已 unwind）
foreignField: '_id',
as: 'stocks'
}
},
// 步骤 4：再次 $unwind，因为 $lookup 的 as 结果是数组（即使只匹配 1 条）
{ $unwind: '$stocks' },
// 步骤 5：筛选出库存颜色匹配的文档
{ $match: { 'stocks.color': targetColor } },
// 步骤 6（可选但推荐）：移除重复商品（因一个商品多条 red 库存会生成多条结果）
{ $group: { _id: '$_id', product: { $first: '$$ROOT' } } },
{ $replaceRoot: { newRoot: '$product' } }
]).exec();
res.status(200).json({
success: true,
count: products.length,
data: products
});
} catch (err) {
next(err);
}
};? 关键注意事项：
- 集合名大小写敏感：$lookup.from 必须填写实际 MongoDB 集合名（如 stocks），默认为模型名小写复数（可通过 Stock.collection.name 确认）；
- ObjectId 类型转换：req.categoryId 必须转为 mongoose.Types.ObjectId，否则 $match 无法正确比较；
- 双重 $unwind 必不可少：第一次展开原始 stocks: [ObjectId]，第二次展开 $lookup 后的 stocks: [StockDoc]；
- 去重逻辑：若一个商品有多个 color: "red" 的库存，聚合会返回多条相同商品（仅 stocks 子文档不同）。最后的 $group + $replaceRoot 可确保每个商品唯一；
-
性能优化建议：为 Product.categories 和 Stock.color 字段建立索引：
// 在 ProductSchema 中添加 ProductSchema.index({ categories: 1 }); // 在 StockSchema 中添加 StockSchema.index({ color: 1 });
该方案完全绕过 populate 的语义限制，利用聚合管道的表达能力实现真正的“带子文档条件的父文档筛选”，是处理此类一对多关联过滤场景的标准实践。
