如何在MongoDB/Mongoose中填充订单嵌套数组的关联产品？

我有一个orders集合，每个订单结构如下：

{
  "_id": "5252875356f64d6d28000001",
  "lineItems": [
    { productId: 'prod_007', quantity: 3 }, 
    { productId: 'prod_003', quantity: 2 }
  ]
  // 其他字段省略
}

同时还有一个products集合，每个产品包含唯一的productId字段。需要将每个lineItem.productId替换为products集合中匹配的完整产品对象，对应的Schema定义如下：

const orderSchema = new Schema({
  checkoutId: {
    type: String,
    required: true,
  },
  customerId: {
    type: String,
    required: true,
  },
  lineItems: {
    type: [itemSubSchema],
    required: true,
  },
});

const itemSubSchema = new Schema(
  {
    productId: {
      type: String,
      required: true,
    },
    quantity: {
      type: Number,
      required: true,
    },
  },
  { _id: false }
);

const productSchema = new Schema({
  productId: {
    type: String,
    required: true,
  },
  name: {
    type: String,
    required: true,
  },
  imageURL: {
    type: String,
    required: true,
  },
  price: {
    type: Number,
    default: 0, 
  },
});

方式一：MongoDB原生聚合管道 #

直接用聚合操作关联两个集合，替换字段：

db.orders.aggregate([
  {
    $lookup: {
      from: "products",
      localField: "lineItems.productId",
      foreignField: "productId",
      as: "matchedProducts"
    }
  },
  {
    $addFields: {
      lineItems: {
        $map: {
          input: "$lineItems",
          as: "item",
          in: {
            $mergeObjects: [
              "$$item",
              {
                product: {
                  $arrayElemAt: [
                    "$matchedProducts",
                    { $indexOfArray: ["$matchedProducts.productId", "$$item.productId"] }
                  ]
                }
              }
            ]
          }
        }
      },
      matchedProducts: "$$REMOVE" // 清理临时字段
    }
  }
])

操作逻辑：

1. $lookup批量关联products集合，把所有匹配的产品存入matchedProducts临时数组
2. $map遍历每个lineItem，通过$indexOfArray找到当前item对应产品在matchedProducts中的位置，用$arrayElemAt取出产品对象，再和原item的字段（比如quantity）合并成新的对象
3. 最后移除临时的matchedProducts字段

如果想直接替换原productId字段为产品对象，修改$mergeObjects部分即可：

in: {
  $mergeObjects: [
    { quantity: "$$item.quantity" }, // 保留数量字段
    { $arrayElemAt: [
      "$matchedProducts",
      { $indexOfArray: ["$matchedProducts.productId", "$$item.productId"] }
    ]}
  ]
}

方式二：Mongoose填充（Populate） #

通过修改Schema配置，用Mongoose自带的populate功能实现：

1. 修改Schema配置 #

给子文档的productId加上引用关联：

const itemSubSchema = new Schema(
  {
    productId: {
      type: String,
      ref: 'Product', // 指定引用Product模型
      required: true,
    },
    quantity: {
      type: Number,
      required: true,
    },
  },
  { _id: false }
);

// 确保先定义Product模型
const Product = mongoose.model('Product', productSchema);
const Order = mongoose.model('Order', orderSchema);

2. 查询时执行填充 #

Order.find()
  .populate({
    path: 'lineItems.productId',
    model: 'Product'
  })
  .exec((err, orders) => {
    if (err) {
      console.error(err);
      return;
    }
    // 此时lineItems里的productId已经是完整的产品对象
    console.log(orders);
  });

如果想把填充后的字段重命名为product（而不是保留原productId字段名），可以添加as选项：

.populate({
  path: 'lineItems.productId',
  model: 'Product',
  as: 'lineItems.product'
})

这种情况下原productId字段会保留，若要移除，可在查询后手动处理，或者结合聚合管道实现。

内容的提问来源于stack exchange，提问作者xandert.93