Mongoose聚合查询在cursorId不存在时仍返回文档的问题排查

你遇到的问题核心在于：MongoDB的ObjectId是具备可比较性的有序值，即使cursorId对应的文档不存在，它依然会作为一个合法的ObjectId与集合中所有文档的_id进行大小比较。

如果传入的cursorId是一个比集合中所有文档_id都大的有效值，那么所有文档都会满足_id < cursorId的条件，再经过$sort和$limit后，自然会返回最新的10条文档。

要实现「cursorId不存在时返回空数组」的需求，需要先验证cursorId对应的文档是否存在，再决定是否执行聚合查询。具体步骤如下：

1. 验证cursorId的有效性：先确认传入的cursorId是合法的ObjectId，避免无效值导致的报错。
2. 检查文档是否存在：通过exists方法快速判断集合中是否存在该_id的文档。
3. 分支执行逻辑：文档不存在则直接返回空数组；存在则执行原聚合管道。

示例代码 #

async function fetchDocuments(cursorId) {
  // 验证cursorId是否为合法的ObjectId
  if (!mongoose.Types.ObjectId.isValid(cursorId)) {
    return [];
  }
  const targetId = new mongoose.Types.ObjectId(cursorId);

  // 检查目标文档是否存在
  const documentExists = await myCollection.exists({ _id: targetId });
  if (!documentExists) {
    return [];
  }

  // 执行原聚合查询
  return await myCollection.aggregate([
    { $sort: { createdAt: -1 } },
    { $match: { _id: { $lt: targetId } } },
    { $limit: 10 }
    // 后续其他聚合阶段...
  ]).exec();
}

• 使用exists方法比findOne更高效，因为它只返回布尔值，无需加载完整文档。
• 如果业务场景允许，也可以在聚合管道内通过$lookup或$count实现存在性判断，但单独的exists查询在性能上更优。

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