MongoDB聚合报错：newRoot表达式需返回对象，值为MISSING

从错误日志的输入文档能看到：user: []——也就是$lookup没有找到匹配的用户数据，返回了空数组。后续用$arrayElemAt: ["$user", 0]取数组第一个元素时，结果就是MISSING（不存在），而$replaceRoot要求newRoot必须是一个对象，因此直接触发报错。

另外你聚合逻辑里的$limit和$skip顺序搞反了，应该先执行$skip再执行$limit，否则分页逻辑会完全错误。

方案1：过滤无匹配用户的文档 #

在$lookup之后、$replaceRoot之前，添加$match阶段过滤掉user数组为空的文档，避免后续阶段处理无效数据：

const users = await locations.aggregate([
  {
    $geoNear: {
      near: {
        type: "Point",
        coordinates: [req.query.longitude, req.query.latitude],
      },
      maxDistance: 2000,
      distanceField: "dist.calculated",
      spherical: true,
    },
  },
  {
    $lookup: {
      from: "users",
      localField: "userId",
      foreignField: "_id",
      as: "user",
    },
  },
  // 新增：过滤无匹配用户的文档
  { $match: { user: { $ne: [] } } },
  {
    $replaceRoot: {
      newRoot: {
        $arrayElemAt: ["$user", 0],
      },
    },
  },
  {
    $project: {
      _id: 1,
      userId: 1,
      name: 1,
      profession: 1,
      hide: 1,
      profilePhotoLink: 1,
      uid: 1,
    },
  },
  // 调整顺序：先skip再limit
  { $skip: pageSize * (req.query.page - 1) },
  { $limit: pageSize },
]);

方案2：保留文档并设置默认用户数据 #

如果不想丢弃无匹配用户的location文档，可以用$ifNull给newRoot设置默认对象：

const users = await locations.aggregate([
  {
    $geoNear: {
      near: {
        type: "Point",
        coordinates: [req.query.longitude, req.query.latitude],
      },
      maxDistance: 2000,
      distanceField: "dist.calculated",
      spherical: true,
    },
  },
  {
    $lookup: {
      from: "users",
      localField: "userId",
      foreignField: "_id",
      as: "user",
    },
  },
  {
    $replaceRoot: {
      newRoot: {
        $ifNull: [
          { $arrayElemAt: ["$user", 0] },
          // 默认空用户对象，字段可按需调整
          { _id: null, userId: "$userId", name: "Unknown", profession: "", hide: false, profilePhotoLink: "", uid: "" }
        ]
      },
    },
  },
  {
    $project: {
      _id: 1,
      userId: 1,
      name: 1,
      profession: 1,
      hide: 1,
      profilePhotoLink: 1,
      uid: 1,
    },
  },
  { $skip: pageSize * (req.query.page - 1) },
  { $limit: pageSize },
]);

额外排查建议 #

• 检查locations集合里的userId是否存在无效值（比如关联的用户已被删除），这是$lookup返回空数组的根本原因，可定期清理这类无效数据。
• 确认users集合的_id类型和locations的userId类型完全一致（比如都是ObjectId），避免因类型不匹配导致关联失败。

内容的提问来源于stack exchange，提问作者Harsh Mishra