MongoDB聚合管道展平0或1元素的checkin数组并提取phone字段

最优方案（无需使用$unwind） #

结合你提到的「checkin数组固定为0或1个元素」的场景特点，完全可以跳过$unwind拆数组的操作，直接通过数组索引取值实现需求，既不会丢失空数组对应的原始文档，也能减少不必要的计算开销。

对应的聚合管道配置：

db.your_collection.aggregate([
  // 前置的其他聚合逻辑...
  {
    $addFields: {
      phone: {
        $ifNull: [
          // 直接取checkin数组第0位元素的phone字段值
          { $arrayElemAt: ["$checkin.phone", 0] },
          // 取值为null时（即空数组无匹配元素）返回空字符串
          ""
        ]
      }
    }
  },
  // 移除不再需要的checkin字段，匹配目标文档结构
  { $unset: ["checkin"] }
])

方案逻辑完全匹配转换规则：

• 当checkin为空数组时，$arrayElemAt 会返回null，经$ifNull处理后得到空字符串
• 当checkin包含1个元素时，直接提取对应元素的phone值作为顶层字段
• 全程不会拆分原始文档，1:1保留所有记录，不存在空文档被过滤的问题

$unwind兼容方案（不推荐本场景使用） #

如果你需要沿用$unwind的实现逻辑，只需补充对应配置即可解决空文档被过滤的问题：

db.your_collection.aggregate([
  // 前置的其他聚合逻辑...
  {
    $unwind: {
      path: "$checkin",
      // 关键配置：保留checkin为null/空数组的原始文档，不再做过滤
      preserveNullAndEmptyArrays: true
    }
  },
  {
    $addFields: {
      phone: { $ifNull: ["$checkin.phone", ""] }
    }
  },
  { $unset: ["checkin"] }
])

使用注意：

• 该方案依赖preserveNullAndEmptyArrays: true配置，缺少该参数时空数组文档会被默认过滤，也就是你之前遇到的问题
• 因为你的场景下数组最多1个元素，不会出现文档拆分后条数膨胀的问题，但相比直接索引取值的方案，存在额外的拆数组计算开销

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