Mongoose中$lookup关联查询返回空结果的问题排查与解决

问题场景 #

用Mongoose执行MongoDB聚合查询时，通过$lookup关联userCartSchema和productSchema集合，明明关联集合存在匹配文档，但返回的products数组始终为空。已尝试用$toObjectId转换item字段，也检查过字段和集合名拼写，问题仍存在。

相关代码 #

const productSchema = require('../schemas/product-schemas');
const userCartSchema = require('../schemas/cart-schema');

const user = await userCartSchema.aggregate([
  { $match: { user: userId } },
  { $unwind: '$product' },
  {
    $project: {
      item: "$product.item",
      quantity: "$product.quantity"
    }
  },
  {
    $lookup: {
      from: 'productSchema',
      localField: 'item',
      foreignField: '_id',
      as: "products"
    }
  }
])

可能原因及解决方法 #

1. $lookup的from参数错误 #

MongoDB的$lookup中from需要指定数据库实际集合名称，不是Mongoose Schema的变量名。通常Mongoose会自动将Schema名称转为小写复数形式作为集合名，比如productSchema对应的集合名大概率是products，而非productSchema。

解决：
先通过productSchema.collection.name确认实际集合名，再修改from参数：

{
  $lookup: {
    from: 'products', // 替换为查询到的实际集合名
    localField: 'item',
    foreignField: '_id',
    as: "products"
  }
}

2. item字段类型不匹配（转换时机或格式问题） #

如果userCartSchema中的product.item是字符串类型，即便用$toObjectId转换，也可能存在转换时机不对、或字符串不是有效ObjectId格式的问题。

解决：
在$project之后、$lookup之前显式转换字段类型，同时校验字符串格式：

{
  $addFields: {
    item: { $toObjectId: "$item" }
  }
},
{
  $lookup: {
    from: 'products',
    localField: 'item',
    foreignField: '_id',
    as: "products"
  }
}

检查item字符串是否为24位十六进制字符，确保是有效的ObjectId格式。

3. $match阶段过滤掉了数据 #

如果userId的类型和userCartSchema中user字段类型不匹配（比如userId是字符串，user是ObjectId），$match阶段可能没有命中任何文档，后续$lookup自然无结果。

解决：
单独执行$match逻辑验证是否有数据返回：

const testCart = await userCartSchema.find({ user: userId });
console.log(testCart); // 检查输出是否为空

如果无数据，将userId转为ObjectId后再查询：

const mongoose = require('mongoose');
const userObjectId = mongoose.Types.ObjectId(userId);
const testCart = await userCartSchema.find({ user: userObjectId });

4. $unwind阶段丢失数据 #

如果userCartSchema中的product字段是空数组，默认的$unwind会直接过滤掉该文档，导致后续步骤无数据。

解决：
给$unwind添加preserveNullAndEmptyArrays: true参数，保留空数组的文档：

{ $unwind: { path: '$product', preserveNullAndEmptyArrays: true } }

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